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Preface 



This manual describes the READR/SAVER backup utility package. The 
package can be used as a means to distribute software updates, or 
to backup and restore your own files. 



Chapter 1 Introduction. Overview of the READR/SAVER package; 
system requirements. 

Chapter 2 Using READR. READR operations; commands and examples. 

Chapter 3 Using SAVER. SAVER operations; commands and examples. 

Chapter 4 Updating the System Disc. What to do with your 
software updates on minicartridge. 

Chapter 5 Loading READR and SAVER. 

Appendix A Error Messages. 

Appendix B Advanced User and Application Notes. 



NOTE 



All references to RTE pertain to 
RTE-IVB and RTE-6/VM. Specific 
differences pertaining to the 
operating systems are clearly noted 
throughout this manual. 
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Chapter 1 
Introduction 



Overview 

The READR/SAVER package is a pair of file backup and restore 
utilities. The SAVER program saves disc files onto magnetic tape 
or minicartridge in a packed format. The READR program reads 
files from magnetic tape or minicartridge and places them on disc. 

Another main feature of the READR/SAVER package is its flexibility 
in saving and restoring files selectively. 

SAVER creates a file-name table of the files to be saved. It 
writes the file-name table on tape as a directory. SAVER then 
opens each file in turn, writes it to the tape, and verifies the 
file by comparing the tape data bit by bit to the disc data. 
Optionally, the directory may be sorted so that files are easier 
to find. The directory is the first file on tape and is in File 
Manager format. It can be accessed with a FMGR ST or DU command. 

READR allows you to selectively choose which files on tape are to 
be placed on disc. An option to update your disc files is also 
included. If a file already exists on disc, and the update option 
is selected, the disc file will be replaced by the file on tape. 
The tape file will be verified before actual replacement takes 
place. 
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System Requirements 

READR and SAVER execute only on RTE-IVB and RTE-6/VM operating 
systems. Your system configuration must include either: 

7970B/E (9 track) magnetic tape, or 

264x terminal with Cartridge Tape Units using driver DVR05 or 
DVA0 5. 

A library called $RSLIB which contains assembler routines is 
included with the READR/SAVER package. READR requires a minimum 
of 21 pages of memory. SAVER requires a minimum of 23 pages of 
memory. For instructions on how to load READR and SAVER, refer to 
Chapter 5. 
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Chapter 2 
Using SAVER 



Introduction 

The SAVER program copies disc files onto either magnetic tape or 
minicartridge. From the file names you supply, it builds a 
file-name table in memory. You, have the option to sort the 
directory before it is copied to tape. Then each file is copied 
onto the tape and verified bit by bit unless you bypass the 
verification. 

SAVER rewinds the tape at the beginning and end of the program and 
will overwrite any information currently on the tape. Therefore, 
be sure you are using a blank tape or that the contents of the 
tape can be overwritten. SAVER always begins writing on the 
beginning of the tape; it cannot skip over files to write to the 
middle of the tape. 

SAVER Operations 

When SAVER is run interactively, it displays the prompt: 

Command ? 

SAVER enters the command and file search phase. At this time, you 
can specify the files to be saved and enter the commands to set 
the option flags. The SAVER commands and their functions are 
described in the following pages. SAVER takes immediate action on 
some of the commands entered. For example, command "MT,lu" causes 
SAVER to validate the tape LU immediately and "SZ" command causes 
SAVER to display immediately the amount of tape needed to save the 
files thus far specified. You must specify all the files that are 
to be saved on this tape before you complete this phase. This 
phase is completed when you enter the /E command. 
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SAVER enters file save phase, reads and verifies the files from 
the disc and places them on the tape. The first file put on the 
tape will be the directory. It is placed on tape in 
FMGR-compatible format. The directory contains the file namrs 
exactly as they appear on disc, with the same security code and 
cartridge reference. 

SAVER does not have a multiple tape save capability. 

If you entered the PU command either during command and file 
search phase, from a command file> or from a run string, SAVER now 
enters purge phase. You can purge the files on disc if you have 
the correct security code and proper access to group or system 
disc LUs. SAVER asks if you want to purge all of the files or if 
you want to select the files to be purged. 

Scheduling SAVER 

Run SAVER by entering: 

:RU,SAVER[ , option code[, option code...]] 

where the option code is any number of the commands listed in 
below, in any order. If you are running from a runstring, SAVER 
does not give you the opportunity to correct errors or change 
options . 

The following is a list of all commands: 

SAVER COMMANDS: 



EN 



Command 
/A or AB 
/E or 

CO 

EC 

ER,lu 

LI 

MT,lu 

PU 

SE, namr 

SO,lu 

SS 

SZ 

T6 

TR,namr 

TT 

UN,lu 

VE 



action setting 
Abort SAVER immediately 
End search (start saving files) 
Show TR files Comments F +- 
ECho file search CR's F 
Assign ERror LU ## F 
List files flag 
Assign Mag Tape LU ## 8 
PUrge files flag F 
SElect files via namr mask 
SOrt the directory F 
Suspend SAVER 
Display tape SiZe 
Save Type 6 files F 
TRansfer to command file 
Terminal type if TTY F 
UNselect ## of files 
VErify T +-— 

Display SAVER commands & options 



Sort options: 
0=no sort l=Name, SC,CRN 
2=Last5,CRN 3=CRN,Name 
4=CRN,Last5 5=Size, CRN , Name 
6=CRN,size 7=SC, CRN, Name 

(LastB means to sort chars 
2-6 and then char 1 of each 
name) 

NO or NOT in front of any 
command negates or resets 
the state of the setting. 
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Only the first two characters are considered in the command. 
Other characters may be used to increase readability. For 
example, enter EC or ECHO to echo file positioning. 

Any command may be reset by adding NO or NOT in front of the 
command. For example, enter NO PURGE to turn off the purge 
option. The commands EC and VE are initially set to be on. To 
suppress the condition, enter NO EC or NO VE. 

You can create a command file and use the TR,namr to run READR 
from this file. For more information, refer to the explanation of 
the TR command found later in this chapter. A sample command file 
is shown below: 



* sample 

MT,4 

T6 

SE, : :P1 

/E 



SAVER command file 



You may also run SAVER interactively 
commands in the runstring. 



by not specifying any 



If SAVER is to be terminated prematurely, it must be done properly 
so that it can do the appropriate clean up work. Enter the "/A" 
command or "BR, SAVER" at the system breakmode to produce clear 
aborts. If SAVER is not aborted in either of these ways, it may 
have left files with open status. You should not abort SAVER with 
"OF, SAVER". 
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Step-by-Step Instructions 

To use SAVER, follow the step-by-step instructions given below. 
All user inputs are underlined. Note steps 2 through 6 may be in 
any order. 

1. Run SAVER by entering 

: RU, SAVER 
SAVER displays: 

SAVxx, REV. rrrr on @ tttt ddmmmyy with room for ffff files 
where: 

xx LU of the session terminal. 

rrrr Revision code. 

tttt ddmmmyy Time, day, month, and year the program is 

started, 
ffff The largest number of file names allowed in 

the file-name table. 

2. SAVER then prompts: 

Command ? 
Enter 

?? 
to see a list of all commands and options. 

3. Specify the tape LU by entering: 

MT,lu 

LU 8 is the default, LU 4 and LU 5 are usually Cartridge Tape 
Units. Only devices using drivers DVR23 and DVR05 are 
acceptable. 

4. Specify file selection echo by entering: 

EC 

Now, when SAVER searches disc cartridge, it will display a 
disc cartridge header and the namrs of the files it found and 
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are to be saved. 

5„ Select the files to be saved by entering: 

SE f nam r 

The namr may contain masking characters. For example, enter 

SE f & — ::SH to save all files beginning with an & on 

cartridge SH. Specify all files you want to be saved onto this 
tape. You cannot re-enter the search phase after the files 
are stored on tape. No more files may be saved on this tape. 

6. Purge disc files after saving them by entering: 

PU 

7. Enter 

/E 

and SAVER displays approximately how much tape will be needed 

to do the save and asks for permission to continue. When you 

are certain you have enough tape, enter YES and SAVER will 
save the files. 

When SAVER completes the saving, it terminates. 
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Command and File Search Phase 

During this phase, you enter commands to define how SAVER is to 
place the files from the disc onto the tape. These commands are 
explained below. 

CO Comment Echo 

Display the comments in a command file. Comments are ignored by 
SAVER, but by specifying CO, they are displayed with the commands. 

EC Echo 

Enable echoing of the file position. This option is useful if you 
want to know where on the disc SAVER is finding files. For 
instance, if you specify a file namr with no cartridge reference 
number, SAVER searches all discs for that file name. With echo 
enabled, SAVER will display each file namr found and the disc LUs 
it searched. 

ER r lu Error log LU 

Assign another LU as an error log. This is typically a printer or 
other hardcopy device to show errors detected by SAVER in any 
step. 

LI List selected files 

This command provides a compact list of file names. It may be 
used to view the results of the sort command. 



MT,lu Tape LU 

Set the LU number for the tape unit. Initial condition is LU 8. 
The value may be the LU of either a 7970B/E magnetic tape drive or 
the LU number of the Cartridge Tape Unit on a 264x terminal. 
SAVER will immediately verify the LU number. If an invalid LU 
number is given, SAVER displays: 

ERROR. . .SAVER will not work with LU xx 

and allows you to correct the error. If the LU is cartridge tape, 
SAVER resets the hardware straps of the terminal. 
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NOTE 

SAVER does not support the use of the Cartridge Tape 
Units on a multi-point terminal because they do not have 
independent RTE logical units. Also, SAVER does not 
support Cartridge Tape Units (CTUs) on the 16 channel 
(12920) multiplexer because of a conflict in driver 
control codes. 



PU Purge option 

Enter purge file phase after SAVER completes saving and verifying. 
No immediate action occurs as specifying this option simply sets 
the purge option flag. Disc files may be purged only if they are 
on your private cartridge, on a group cartridge if you are group 
manager, or on a system cartridge if you are the System Manager. 
You can choose to purge on a per-file basis. Refer to the Purge 
File Phase section for details. This option can be cancelled by 
entering NO PU. 

The PU command is only needed if the files to be saved are to be 
removed from disc after the save process is complete. PU 
automatically verifies the files, therefore, the NO VE option 
cannot be used. 



SE,namr Search for namr 

Save all files on the disc whose namrs fit the search namr given. 
The format of the search namr is: 

name tsecurity code :cartridge reference number :type 

A character in the file name may be replaced with a "-" (minus 
sign) to create a mask for that character. 

If no name is given (i.e., just the security code or cartridge 

reference are given) the name " " is implied. In other 

words, any name is valid. If the first character is to be masked 
and trailing characters are numbers, an additional "-" has to be 
appended at the end of the file name to distinguish the name from 
an integer value (refer to the examples below) . 
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If a security code is specified, then the security code of each 
file fitting the search name is checked to determine if it is to 
be saved. If no security code is specified, then for private 
cartridges, all files fitting the search name will be saved, and 
for system and group cartridges, all files fitting the search name 
with positive security codes will be saved. You must have group 
or System Manager status to save a read-protected file (i.e., 
files on a group or system cartridge with a negative security 
code) . For any file saved from a group or System Manager 
cartridge, the security code will be saved as zeros if the user is 
not group or System Manager, respectively. 

If a cartridge reference is specified, all files on that cartridge 
matching the search name will be saved. If no cartridge reference 
is specified, then all cartridges will be searched. 

Some examples: 

SE,& ::SH Search for all files beginning with "&" on 

cartridge SH. 

SE,FILE — :JA Search for all file names whose first four 

characters are "FILE" and whose security code 
i s JA . 

SE,::SH Search for all files on cartridge SH the name is 

implied as any file. 

SE,-123- Search for all files whose second through fourth 
characters are "123". 

Example: X123, $123A. 

SE,:::5 Search for all relocatable files (type 5). 

Be sure to specify all files you want placed on tape at this time. 
Once the File Save Phase is entered, you may not specify any more 
files to be placed on that tape. 

SAVER ignores overlapping search file masks (i.e., duplicates). 
However, it will print out a warning message and ask permission to 
continue. If running from a runstring, SAVER displays a warning 
and saves the file specified. 

After each "SE,namr", SAVER enters the namr (or namrs if masks are 
used) into the file-name table in memory. It then reports how 
many new files were placed in the table with that SE command and 
how many file names total is in the table. You may use the LI 
command to see the currently selected file names. 
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SO,n 



Sort directory 



Sort the directory in a manner specified by n, 
from to 7. These are explained below. 



Parameter n ranges 



n 



sort by 



do not sort (the default) . 

1 file name, security code, and then cartridge reference. 

2 last 5 characters in file name, then first character. 

3 cartridge reference, then file name. 

4 cartridge reference, last 5 characters in file name, then 

first character. 

5 file size, cartridge reference, then file name. 

6 cartridge reference, then file size. 

7 security code, cartridge reference, then name. 

The following command list selects a variety of file names. These 
files will be sorted with a few of the sort options listed above. 



Command ? SE,XYZ:SU:P1 



Command 


7 
7 

7 
7 

? 
7 
7 

3t] 


SE,XXYZ:HY:P2 


Command 
Command 


SE,ABC:41:BT 
SE,BTTY:HS:P1 


Command 


SE,ABC:34:CT 


Command 


SE,&XYZ:HY:P2 


Command 


SE, 'XYZ:HY:P2 


Command 
Sort oj 


SO,n 
.on selected 



File directory format af 



Option 1 file name, security 
code, then cartridge 
reference. 



Option 2 last five characters 
in file name, then 
first character 



&XYZ 


•HY:P2 


'XYZ 


HY:P2 


ABC 


:34:CT 


ABC 


:41:BT 


BTTY 


HS PI 


XXYZ 


SU:P1 


XYZ : 


SUrPl 


ABC : 


34:CT 


ABC : 


41:BT 


BTTY : 


HS:P1 


&XYZ : 


HY:P2 


•XYZ : 


HY:P2 


XXYZ : 


SU:P1 


XYZ : 


SU:P1 
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Option 3 cartridge reference, 
then name. 



Option 7 security code, 

cartridge reference, 
then name. 



ABC : 


41: BT 


ABC : 


34:CT 


BTTY : 


HS:P1 


XXYZ : 


SU : PI 


XYZ 


:SU:P1 


&XYZ : 


HY:P2 


'XYZ : 


HY:P2 


ABC 


•34:CT 


ABC 


:41:BT 


BTTY • 


HS:P1 


&XYZ : 


HY:P2 


'XYZ 


HY:P2 


XXYZ 


.SUjPI 


XYZ 


SU:P1 



Sorting (Rev 2226 or later) takes place immediately on the 
currently selected files and also once again just before writing 
the directory to tape. The LI command can be used to see the file 
order. 



SS 



Suspend SAVER 



SS command causes SAVER to pause to allow user to OFF programs, 
mount/dismount cartridges, run WHZAT, etc. The system breakmode 
command 'GO' will resume SAVER. 



SZ 



Display tape size 



Display an estimate of the tape length required to save the files 
selected to this point. The information is displayed immediately 
upon entering the command and also repeated before SAVER enters 
the file save phase. The size is an estimate only due to tape 
retries and small timing differences in tape units. If too many 
files are selected, use the UN command to reduce the file count. 



TR,NAMR 



Transfer to command file 



Transfer to a disc file containing SAVER commands. Namr may not 
be an LU number but may be a type file with read capability. 
SAVER will read commands from that file. The format of the 
commands is the same as those being entered interactively. Lines 
beginning with "*" are ignored to allow for documentation. A TR 
with no namr is an implied TR,1. 
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When running from a command file, SAVER will still allow you to 
take corrective actions if necessary. If the command file ends 
with the /E command, SAVER will terminate following executing the 
commands in the file. If not, SAVER will prompt "Command ?" after 
executing the commands in the file. If the TR file has no /E, the 
end of the file is taken as an implied /E. 

TT Hardcopy Mode 

Select hardcopy mode for dialogue on a hardcopy terminal. SAVER 
inserts a line feed at the end of each line. Initial condition is 
the CRT mode with no line feed. This is done to minimize 
scrolling data off the CRT. This option can be cancelled by 
entering NO TT. 

T6 Type 6 file save 

Save type 6 files. You may cancel this option by entering NO T6. 
Type 6 files can only run on the exact operating system on which 
they were loaded. 

UN,n Unselect Files 

The UN command removes previously selected files starting with the 
last file shown by the List command. The mandatory parameter n 
represents the number of files to be removed. This allows 
dropping one or more files when the maximum tape size is exceeded. 
By using the LI,SZ and UN command, the final selection can be 
tailored to the tape being used. 

VE Verify 

Enable verification. Normally after SAVER copies a file onto 
disc, it backspaces the tape and compares the tape file word for 
word with the disc file. This option may be cancelled by entering 
NO VE at the "Command ?" prompt. 

/A or AB Abort SAVER 

Abort SAVER. The other way to abort SAVER properly is to enter 

BR, SAVER at the system breakmode request. One of these two 

methods must be used to allow SAVER to do the appropriate clean up 
activities. 
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/E or EN End of search 

Leave the search phase and enter the file save phase. /E is 
implied at the end of a command file and at the end of a 
runstring. 

?? or ? List all flags and commands 

Display the current status of the option flags and all of the 
commands . 



File Save Phase 



By specifying at least one file namr and entering a /E r SAVER 
completes the search phase. It calculates and displays an 
estimate of the length of the tape needed to save the files and 
asks whether to continue with the prompt "OK to proceed? (Y/N)". 
If writing more than one file to magnetic tape, make sure you have 
enough tape on that one reel. If writing to mini-cartridge, you 
must have enough tape on one cartridge tape to do the save. SAVER 
may be terminated at this point by entering "N". If running from 
control of a runstring or command file, SAVER skips this question 
and starts saving immediately or aborts if multiple files on 
multiple reels are required. 

SAVER writes the file-name table onto the tape as the directory. 
It then opens each file in turn and writes it to the tape in a 
packed format (refer to Appendix B for a description of the tape 
format) . 

SAVER is not interactive during this phase. However, you may 
terminate it by entering "BR, SAVER" in the system breakmode. Note 
that the tape is not complete and should not be used to restore 
files. 

After each file is saved, SAVER backspaces the tape and compares 
the tape file to the disc file bit by bit. Verification can be 
disabled with NO VE. 

If PU was not specified, SAVER terminates at the end of the file 
save phase. 
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File Purge Phase (optional) 

After SAVER completes the file save phase, if you have specified 
PU, it will prompt: "Purge files (NO, SOME, or ALL)?" 

NO SAVER terminates. 



ALL SAVER asks "Are you sure (Y/N) " Any other answer 
besides "Y" will be taken as "N" and the Purge files 
prompt returns. A "Y" answer will cause the disc 
files that were saved on tape to be purged. 

SOME SAVER displays: "SAVER will ask permission for each 
file. . .answer Yes, No or Quit". Then for each file, 
SAVER prompts: "Purge name:sc:crn (Yes/No/Quit)?". 
YES will purge the file, NO will skip over this file 
and cause the next file prompt to be given, QUIT will 
terminate SAVER. 



In the session environment, there are restrictions on the purge 
operation for group and session cartridges. Files on a group 
cartridge may only be purged by the group or System Manager. 
Files on a system cartridge may only be purged by the System 
Manager. Files on a non-session cartridge can only be purged by a 
non-session user or System Manager. 

When SAVER completes this phase, it terminates. 
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Examples 



1. In this example, the user is simply saving a group of files 
onto minicartridge. The user sets hardcopy mode (TT) and the 
LU is specified (MT,4) followed by the search file namr. The 
SZ command tells him how much tape SAVER will use. He is 
satisfied with that number so he enters /E to start. SAVER 
asks if the tape size is correct, the user enters Y and SAVER 
creates and verifies the directory. Then SAVER saves and 
verifies each file and displays out the full namr and tape file 
number for each file. 

: RU, SAVER 

SAVER, REV. 2226 on @ 1217 18MAY82 with room for 779 files. 

Command? ?? 



SAVER 



COMMANDS: 



Command action setting 

VE VErify T 

T6 Save Type 6 files F 

EC ECho file search CR's F 

TT Terminal type is TTY F 

PU PUrge files flag F 

CO Show TR files Comments F 

LI List files flag 

MT,## Assign Mag Tape LU ## 8 

S0,## SOrt the directory F 

ER,## Assign ERror LU ## F 

UN,## UNselect ## of files 

SZ Display tape SiZe 

SS Suspend SAVER 

TR,namr TRansfer to command file +- 

SE,namr SElect files via namr mask 

/E or EN End search (start saving files) 

/A or AB Abort SAVER immediately 



Sort options: 
0=no sort l=Name ,SC,CRN 
2=Last5,CRN 3=CRN,Name 
4=CRN,Last5 5=Si ze , CRN , Name 
6=CRN,size 7=SC , CRN, Name 

(Last5 means to sort chars 
2-6 and then char 1 of each 
name) 

NO or NOT in front of any 
command negates or resets 
the state of the setting. 



To reset any option, type NO or NOT in front of the command, 
for example: NO EC turns off the file search echo. 

Command? TT 
Command? MT,4 
Command? SE,&S : :SU 



3 New files, 



3 total. 
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Command? S2_ 

Apx. 2.9 ft @ 800 BPI, 2.1 ft @ 1600 BPI magtape 
or 56.8 inches on CTU's. 
Command? /E 

Apx. 2715" ft @ 800 BPI, 2.1 ft @ 1600 BPI magtape 
or 56.8 inches on CTU's. 
OK to proceed? (Y/N) Y_ 
<<RTE FILE SAVE 1217 18MAY82. 3 FILES. 7. BLOCKS R= 128. REEL= 1» 



Create directory 
Verify directory 

Saving &SUJO : 

Verify 

Saving &STBIT: 

Verify 

Saving &SUE : 

Verify 



SAVER off @ 1219 18FEB81 



0: 


SU: 


4: 


2: 





0: 


SU: 


4: 


3: 





0: 


SU: 


4: 


2: 






2. In this example, the user is again sav 
time requests to purge the disc files 
verified. The minicartridge LU (MT,4) 
file namr is &-OMEY: :SU. SAVER found 3 
mask. The purge option (PU) is spe 
execute. After saving and verifying 
the purge phase by prompting "Purge fi 
The user answers SOME. He specifically 
&COMEY so he answers YES to the reques 
others. An alternative is to answer 
first file. 



ing a few files but this 
after they are saved and 

is given and the search 

files fitting that namr 
cified and then /E to 
all files, SAVER enters 
les (NO, SOME or ALL)?". 

wants to purge the file 
t. He answers NO to the 

QUIT after purging the 



t RU , SAVER 

SAVER, REV. 2226 on @ 1224 18MAY82 with room for 779 files. 

Command? MT,4 

Command? TT 

Command? SE,&-OMEY; ;SU 

3 New files, 3 total. 
Command? PU 
Command? "JE 

Apx. 2.9 ft (a 800 BPI, 2.1 ft <a 1600 BPI magtape 
or 53.2 inches on CTU's. 
OK to proceed? (Y/N) Y_ 
<<RTE FILE SAVE 1224 18MAY82. 3 FILES. 6. BLOCKS R= 128. REEL= 1» 
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Create directory 
Verify directory 

Saving &COMEY: 0: SU: 4: 2: 1 

Verify 

Saving &D0MEY: 0: SU: 4: 2: 2 

Verify 

Saving &H0MEY: 0: SU: 4: 2: 3 

Verify 

Purge files (NO, SOME or ALL)? SOME 

SAVER will ask permission for each file. . .answer YES, NO or QUIT 

Purge &COMEY : 0: SU: 4: 2: (Yes/No/Quit)? YES 

1 &COMEY: 0: SU: 4: 2: purged. 

Purge &DOMEY : 0: SU: 4: 2: (Yes/No/Quit)? NO 

Purge &HOMEY : 0: SU: 4: 2: (Yes/No/Quit)? NO 

SAVER off P 1226 18MAY82 



3. In this example, SAVER is run using a runstring. The user 
specifies the magnetic tape LU (MT,8) , the search file namr 
SSS::SU, and the purge option (PU) . The /E ends the string. 
For the purge option, SAVER always goes interactive. In this 
case, the user failed to enter anything and when the terminal 
timed out, SAVER interpreted this as a 'NO* command. 

: RU,SAVER,TT,MT,8,SE,SSS: :SU,PU,/E 

SAVER, REV. 2226 on @ 1246 18MAY82 with room for 779 files. 

1 New files, 1 total. 
Apx. 1.0 ft i 800 BPI, .7 ft @ 1600 BPI magtape 
or 25.1 inches on CTU's. 
<<RTE FILE SAVE 1246 18MAY82. 1 FILES. 2. BLOCKS R= 128. REEL= 1>> 

Create directory 
Verify directory 

Saving SSS : 0: SU: 4: 2: 1 

Verify 

Purge files (NO, SOME or ALL)? 

SAVER off @ 1246 18MAY82 
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Chapter 3 
Using READR 



Introduction 

The READR program reads files from either magnetic tape or 
minicartridges and restores them to a disc cartridge. You decide 
which files are to be read and on what disc cartridge they are to 
be placed. The files can be verified as they are read. You may 
want to replace the same files on the disc if, for instance, the 
files on tape are more recent (i.e., they contain software 
updates) . 

When the files on tape were saved, the entire file namr was placed 
in the directory. Unless you specify otherwise, the files will be 
restored by READR onto the same disc cartridge and with the same 
security code from which they were saved. READR provides an 
option to display the directory. 

READR Operations 

When READR is run interactively, it displays the prompt: 
Command ? 

READR enters the command and file selection phase. At this time, 
you may optionally specify the destination, security code, update 
function, and verification state among others. READR takes 
immediate action on some of the commands entered. For example, 
the LI command will immediately print the tape directory and MT,lu 
will immediately validate the tape LU. Now you can declare the 
files to be restored. This phase is completed when you enter the 
/E command. 

READR enters the file restoration phase and restores the tape 
files to disc in the manner you requested. If READR has problems 
restoring a file, it displays an error message and, if possible, 
prompts you for corrective action. When it has completed 
restoring the specified files, it reprompts "Command ?" . You may 
now change any of the options and specify another group of files. 
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The commands and option flags are explained later in this chapter. 
If no more files are to be restored, READR is terminated with a /E 
command. 

In restoring a large file saved on more than one magnetic tape, 
READR will prompt you to mount the next tape. Multiple files on 
multiple tapes are not available. 

Scheduling READR 

Run READR by entering: 

RU, READR [, option code [ , option code...]] 

where the option code is any number of the commands listed below 
in any order. If you are running from a runstring, READR does not 
give you the opportunity to correct errors or change options. 

Command Explanation Default Values 

AL:#:# Restore all files (NO) 

CO Comment Echo Echo off. 

EC Echo file positioning Echo on. 

LI:lu List directory, lu is output Log LU. 

device 

MT,n magtape or minicartridge LU LU 8. 

OC,n cartridge reference number File's original CRN as 

override saved. 

OS,n security code override File's original SC. 

SE,namr Masked file name restore Restore selected files. 

TR,namr Transfer to command file N/A 

TT Select hardcopy mode CRT mode. 

UP Update files mode Update off. 

VE Verify Verify on. 

/A Abort READR 

/E Exit option setting mode 

?? List all flags and commands 

Only the first two characters are considered in the command. 
Other characters may be used to increase readability. For 
example, enter EC or ECHO to echo file positioning. 

The commands OC, OS, TT, and UP, may be reset by adding NO or NOT 

in front of the command. For example, enter NO UPDATE to turn off 

the update function. AL, EC and VE are initially set on. To 
suppress the condition, enter NO AL, NO EC, or NO VE. 
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You can create a command file and use the TR,namr command to run 

READR from this file. For more information, refer to the 

explanation of the TR command found later in the chapter. A 
sample command file is shown below: 

*READR Command File 
MT,4 

SE,&-- 

OC,SU 
/E 



You can also run READR interactively by not specifying 
commands in the runstring. 



any 



If READR is to be terminated prematurely, it must be done properly 
so that it can do the appropriate clean up work. Enter the n /A" 
command or "BR r READR" at the system breakmode to produce clean 
aborts. If READR is not aborted in either of these ways, it may 
leave files in open status or it may not be able to purge scratch 
disc files. 



Step-by-Step Instructions 

To use READR, follow the step-by-step instructions given below. 
All user inputs are underlined. Note that steps 3-7 may be in any 
order. 

1. Run READR by entering: 

: RU , RE ADR 

READR displays: 

REAxx REV. nnnn on @ tttt ddmmmyy with room for ffff files 

where: 

xx LU of the session terminal. 

nnnn Revision code of the program. 

tttt ddmmmyy Time, day, month and year the program is 

started, 
ffff Maximum number of files that can be read from 

the tape directory. 
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2. READR then prompts: 

Command ? 
Enter 

21 
to see a list of all commands and options. 

3. Specify the tape LU by entering: 

MT,n 

LU 8 is the initial condition, LU 4 and LU 5 are usually 
Cartridge Tape Units. Once the directory is read, MT is no 
longer changeable. 

4. (optional) List the tape directory by entering: 

LI 
or to print the directory on LU 6: 
LI:6 

5. Select the files to be restored. This is done one of three 
ways: 

- Select all the files on the tape by entering: 

AL 

- Select a group of files by using a masking character. For 
example, enter: 



SE,&- 



to restore all files beginning with an &. 
- Restore a single file by entering: 
SE,namr 

Do not forget to specify the security code and cartridge 
refence number to distinguish one file name from another 
identical name in the tape directory. 
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6. Check the cartridge and security code of the tape file. READR 
will restore a file to the same cartridge as given in the tape 
file namr. If you want the file restored to a disc cartridge 
other than that of the tape file namr, enter: 

OC,n 

where n is the new disc cartridge reference number where the 
tape file is to be restored. 

The same situation exists for the security code. If you want 
the file restored with a security code other than that of the 
tape file namr, enter: 

OS,n 

where n is the new security code of the restored file. 

7. READR will update your disc files with the files on tape if 
you enter: 

UP 

If UP was previously set, you may turn the option off with NO 
UP. 



8. Enter: 

and READR will go into file restoration phase during which it 
will restore the file(s). When it completes that phase, READR 
prompts: 

Command ? 



9. At this point, either enter /E to terminate READR or repeat 
the preceding steps 4-8. 
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Command and File Selection Phase 

During this phase, you enter commands to define the manner in 
which READR is to retrieve the files from the tape. The following 
paragraphs give detailed explanations about each command. 

AL:#:# Restore all files 

Restore files on the tape to disc. If SE,namr is entered after AL 
during the same phase, it will override the AL command. The # 
signs represent starting file number and ending file number 
parameters. They are optional. If no options are entered 
following AL, the default is to restore all files. Thus, AL:3:17 
will restore files 3 through 17 and AL will restore all files. 

CO Comment Echo 

Display comments in a command file. Normally, READR ignores 
comments in command files. Enter CO and READR will list the 
comments along with the commands in the file. 

EC Echo 

Enable echoing of the tape position. This option is useful if you 
are seeking a single file at the middle of the tape. By echoing 
the tape position, you will know the current tape position and the 
position of the desired file. Initial condition is echo on. The 
option may be cancelled by entering NO EC at the "Command ?" 
prompt. 

LI:lu List tape file directory 

List the tape directory to the user's terminal if :lu is not 
specified. The list may optionally be sent to a printer by 
appending the printer LU with a colon. For example, LI : 6 will 
print the directory on LU 6. 

The directory can also be accessed with the FMGR DU or ST command. 
For example, to print the directory on the tape at LU 4 to the 
line printer at LU 6, enter :DU,4,6 or :ST,4,6. 
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Immediately upon entering LI for the first time, READR outputs the 
tape headers 

<<RTE FILE SAVE tttt ddmmmyy. f FILES, bb BLOCKS, R=rrr. REEL=1 >> 

where: 



tttt Time when the save was done, 
ddmmmyy Day, month and year of the save, 
f Number of files on the tape, 
bb Total number of blocks in all of 
rrr Record size in words. 
1 Tape reel number. 



the files. 



The tape directory is then read and 
diplayed (or sent to the specified LU) 



in the following format 



n 

where: 

n 

name 
sc 
cr 

ty 
sz 
r 



name : 



sc : 



cr : 



ty: 



sz 



Tape file number. 

File name. 

File security code. 

File cartridge. 

file type. 

File size. 

Record size (type 2 only) . 



For each subsequent entry of the LI command, READR immediately 
displays the directory as shown above without rereading the tape. 



MT,n 



Tape LU 



Set the LU number n, for the tape unit. If n is not entered, the 
default is LU 8. The value n may be the LU of either the 7970 
magnetic tape drive or one of the LU numbers of the Cartridge Tape 
Units (CTUs) on a 264x terminal using driver DVR05 or DVA05. 
READR will immediately verify the LU number. If an invalid LU 
number is. given, READR displays: 

Magtape specified is not defined or invalid. 



and if run interactively, allows you to 
is LU 4 or LU 5 (cartridge tape units) , 
straps of the terminal. 



correct the error. If LU 
READR resets the hardware 
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NOTE 



OC f n 



READR does 
multi-point 
independent 
support CTUs 



not support the use of 

terminal because they 

RTE logical units. Also, 



the CTUs on a 
do not have 
READR does not 



on the 12920 16-channel multiplexer because 



there is a conflict in driver control codes. 



Override Disc Cartridge 



Restore the files on tape to n, the disc cartridge specified. 
Normally, READR restores the files to the cartridge reference 
number (CRN) of the tape file namr. This command allows you to 
replace that CRN with another n. Parameter n is either a positive 
CRN, negative LU number, or zero to use any cartridge with enough 
room for the file. The cartridge override is cancelled by 
entering NO OC or entering OC with no parameter in interactive 
mode or from a transfer file. 



OS,n 



Override Security Code 



Restore the files on tape to disc wi 
code. Normally, READR uses the securi 
they were saved. The parameter can be 
The security code override is cancel 
entering OS with no parameter in in 
transfer file. OS can be used to update 
the security code of the file on disc, 
match security codes when updating file 
SC when saved, and second with the OS, 



th the specif 
ty code the f 
positive, nega 
led by enter i 
teractive mod 
files on disc 
Two attempts 
s. Once the f 
sc parameter ( 



ied security 
iles had when 
tive or zero, 
ng NO OS or 
e or from a 
by supplying 
are made to 
iles original 
if supplied) . 



SE,namr Select all files matching namr to restore 
SE:#:#,namr Select file # through file # to restore 
SE,n Select file number n to restore 

To select all the files for a particular namr from a tape to 
restore to disc, the command SE,namr is used. The format of the 
search namr is: 

file name rsecurity code :cartridge reference number 

This can be used to select files containing specific characters, 
security codes, and CRNs . 
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Examples: 

SE,$ Select all files beginning with "&". 

SE,FILE — Select all file names whose first four characters 

are "FILE". 
SE,::P1 Select all files that were stored on cartridge PI. 
SE, — LIB-jSH Select all files whose third through fifth 

characters are "LIB" and whose security code 

is "SH" . 
SE,-123- Select all files whose second through fourth 

characters are "123" such as A123 or $123X. 
SE,:::5 Select all type 5 files. 

The user can specify the beginning file number and ending file 
number by using the optional :#:#,namr parameters. For example, 
to select files four through 15: 

SE:4: .15,— 

READR requires input in the namr parameter. If there is no 
specific file namr, use dashes. If a namr is given, the select 
command looks like this. 

SE:4:15,FILE — 

This command tells READR to select all the files between file 
number 4 and file number 15 that begin with "FILE". A character 
in the file name may be replaced with a "-" (minus sign) to create 
a mask for that character. 

Another way to select a file is to use the SE,n command. This 
allows the user to select according to the sequence number of the 
file on the tape. The n represents the sequence number. 

Example: 

SE,125 

This would select the 125th file on tape. 

Only one SE,namr can be effective during a particular file 
selection phase. Entering a second SE,namr during a selection 
phase will override the first. An AL command entered after an 
SE,namr will likewise override a previous SE,namr. Once the 
selected file(s) are restored, a new SE,namr may be entered. 

The SE,n where n is a file number, is useful when partial restores 
are needed and the tape needs to continue in a later session at a 
specific file number. 
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TR,namr Transfer to command disc file 

Transfer to a disc file containing READR commands. Namr may not 
be an LU number but may be a type file with read capability. 
READR will read commands from that file. The format of the 
commands is the same as those being entered interactively. Lines 
beginning with "*" are ignored to allow for documentation. A TR 
with no namr is an implied TR,1. 

When running from a command file, READR will still allow^ you to 
take corrective actions if necessary. If the command file ends 
with the /E command, READR will terminate after executing the 
commands in the file. If not, READR will prompt "Command ?" after 
executing the commands in the file. 

TT Terminal Type 

Select hardcopy mode for dialogue on a hardcopy terminal. READR 
inserts a line feed at the end of each line. Initial condition is 
the CRT mode with no line feed. This option can be cancelled by 
entering NO TT. 

UP Update 

Replace each disc file with a tape file of the same name. READR 
does this by creating a scratch file, restoring and verifying the 
tape file to the scratch file, purging the old disc file, and 
renaming the scratch file. It will not perform the update if 
errors occured on the verification or if the disc file cannot be 
purged (i.e., its security code does not match the security code 
of the tape file name or "OS,n" command) . Update mode 
automatically invokes the verify option and as long as UP is set, 
verify may not be reset. The option may be cancelled by entering 
NO UP. 

If a tape error occurs, READR does not overwrite the existing disc 
file in update mode. Instead, READR creates a scratch file on the 
same disc cartridge of the disc file. Therefore, you must have 
enough room on the cartridge to hold the scratch file. You may 
have to pack the disc cartridge periodically in order to update 
many files. In this case, the optional start and finish file 
numbers (AL and SE commands) will be useful. 
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VE 



Verify 



Enable verification of the files on tape. Normally, READR reads a 
file from the tape and copies it to disc; it will compare the tape 
file to the disc file bit by bit. This process may be cancelled 
by entering NO VE at the "Command ?" prompt. 



Verifying does take extra time, but the accuracy 
files cannot be known without a verify pass, 
automatically with the UPdate command and may not 
until UPdate is cancelled. 



of the restored 
Verify is set 
be turned off 



/A 



Abort READR 



Abort READR. The other way to abort READR properly is to enter 
BR, READR from system breakmode. One of these two methods must be 
used to allow READR to do the appropriate clean up activities. 
OF, READR is not recommended under any circumstances. 



/E 



End of Command and File Selection Phase 



Leave the command and file selection phase and begin the 
restoration phase. READR will restore files as you have commanded 
it to do. To terminate READR, enter /E without defining any 
search namr with SE,namr or AL. /E is implied by reaching the end 
of file in a command file, or by reaching end of the runstring. 

?? or ? List all flags and commands 

Display the current status of the option flags and all of the 
commands . 
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File Restoration Phase 



By specifying a search file namr and entering /E, READR begins the 
file restoration phase. It displays the header record from the 
directory on the tape: 

<<RTE FILE SAVE tttt ddmmmyy. f FILES, bb BLOCKS, R=rrr. REEL=1 >> 

where? 

tttt Time when the files were saved, 

ddmmmyy Day, month and year. 

f Number of files on the tape. 

bb Total number of blocks in all of the files. 

rrr Record size in words. 

1 Tape reel number. 

READR uses the file name, security code and cartridge fields given 
in the SE,namr command or AL command to search the file tape 
directory. READR then positions the tape, reads and restores the 
file(s) on disc. It performs the verify operation unless verify 
was cancelled. 

If you specified the update option, READR creates a scratch disc 
file, reads the tape file onto disc, and verifies it, attempts to 
purge the old disc file and renames the scratch file. The 
security code of the disc file must match the security code of the 
tape file or the security code specified in the OS,n command; 
otherwise, the update is not done. 

If no file is found on tape with the specified search namr, READR 
displays: 

No file fitting search namr found on this tape 

and returns to command and file selection phase. 

If the file extends beyond one tape reel, READR will prompt you to 
mount the next tape and use the header and directory to determine 
that the correct reel was given. 

If READR encounters a problem in trying to create the new file 
name (UP has not been selected) , it will print: 

GREAT error nnn. /A, HElp, PUrge, ALter, OC,n, OS,n, or SKip 
this file? 



3-12 



Using READR 



Error nnn is the FMP error code returned by the CREAT call. READR 
will wait for instructions to correct the error. 

Enter: 

/A To terminate READR. 

HE For more information about the error. 

PU To purge a duplicate disc file, if one exists and restore 
the file. 

AL To alter the file namr that READR is trying to create. 
READR displays the namr and prompts you to enter a new 
namr. This is- a temporary change for the current file 
only. For this response, enter only the parameters that 
are to be changed. For example, if you want to alter 
the cartridge reference on the namr to su, enter : :SU. 
READR will change the cartridge reference without 
affecting the name or security code parameters. The 
name may also be changed at this point. 

OS,n To permanently alter the security code for all remaining 
files. 

OC,n To permanently alter the disc cartridge reference for all 
remaining files. 

SK Skip to next file or, if all files have been restored, 
return to command and file selection phase. 

A carriage return or any other response returns to the Command ? 
prompt. 



Examples 

The first example is a simple restoration of all files on a 
minicartridge. The user ran READR interactively and begin by 
requesting to see all commands and flags (??) . Then, he 
selected hardcopy mode (TT) and a tape unit (MT,4). He asked 
for a directory of the tape (LI) and READR immediately listed 
it. He asked to have all the files restored (AL) , then 
entered /E to enter the file restoration phase. READR 
displayed the tape header showing when the save was done and 
the number of files on the tape. READR then restored and 
verified each file. When it completed, it prompted Command ? 
and waited for more instructions. The user entered /E and 
since no more search namrs were specified, READR terminated. 

: RU, READR 

REA86 REV. 2226 on 1401 18MAY82 with room for 1238 files 

Command? ?? 
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Command 

/E or EN 

/A or AB 

SS 

UP 

VE 

TT 

TR,namr 

LI:<lu> 

MT,n 
AL:#:# 

SE: # :# r namr 

EC 

CO 

OC,n 

OS,n 

Command 
Command 
Command 



Action 

ENd option setting mode 

ABort READR 

Suspend READER 

UPdate files mode 

VErify 

Terminal type is TTY 

Transfer to command file 

List file directory, <lu> 

may be a printer 

Select MagTape LU 

Restore all files 

#:# = start:finish file #. 

Select filemask to restore 

#:# = starttfinish tape file 

ECho tape positioning 

Echo TR file comments 

Override CRN 

Override S.C. 

? TT 

? MT,4 

? LI 



Setting 



#/ 

T 

F 

F 

F 



To reset any option, 
type NO or NOT in 
front of the command 



<<RTE FILE SAVE 1635 
TAPE DIRECTORY 

1 TSTRS1: 

2 TSTRS3: 

3 TSTRS4: 

4 TSTRS5: 

5 TSTRS : 

6 TSTRS2: 
END OF DIRECTORY 
Command? AL 
Command? YE 



18MAY82 6 FILES 18. BLOCKS R=128 REEL= 1>>1> 



0: 
0: 
0: 
0: 
0: 
0: 



PI: 
PI: 
PI: 
PI: 
PI: 
PI: 



3: 
3: 
3: 
3: 
3: 
3: 



Restore 

Verify 

Restore 

Verify 

Restore 

Verify 

Restore 

Verify 

Restore 

Verify 

Restore 

Verify 

Command? 



TSTRS1: 
TSTRS3: 
TSTRS4: 
TSTRS 5: 
TSTRS : 
TSTRS2: 



PI 
PI 
PI 
PI 
PI 
PI 



/E 



READR off @ 1403 18MAY82 
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2. This example shows the user again restoring from minicartridge 
(MT,4) and asking for a file directory. This time, however, 
the user asked for only some of the files. When READR tried 
to restore the first file, it found a duplicate file. The user 
entered AL to the question and renamed the file. The user 
entered /E after the next Command ? prompt to terminate. 



; RU, READR 
REA86 REV. 2226 
Command? TT 
Command? MT,4 
Command? LI 



on @ 1414 18MAY82 with room for 1238 files 



<<RTE FILE SAVE 1409 
TAPE DIRECTORY 

1 &LW0FF: 

2 &LWFTN: 

3 &LWFN4: 

4 &LWFFN: 

5 &LWA01: 

6 &LWA0 2: 

7 &LB1.3: 

8 &LB4.1: 

9 &LB4.2: 

10 &LB4.4: 

11 &LB3.1: 

12 &LB1.1: 

13 &LB1.2: 

14 &LB3.2: 
END OF DIRECTORY 
Command? SE,fcLW 



18MAY82 14 FILES 74. BLOCKS R=128 REEL= 1>> 



PI 
PI 
PI 
PI 
PI 
PI 
PI 
PI 
PI 
PI 
PI 
PI 
PI 
PI 



12 
2 
2 
2 
4 
4 
5 
5 
6 
7 
1 

10 
8 
6 



Command? /E 

CREAT error -2 on &LWOFF: 0: PI 

/A,HElp, PUrge, ALter, 0C,n, 0S r n, or SKip 



this file? HE 
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Duplicate file name. 

/A f HElp, PUrge, ALter, OC,n f OS,n, or SKip this file? AL 

Current NAMR is &LWOFF: 0: PI, you may change name, SC f 

and/or CRN. 
Input new namr: &SH0FF: 



Restore 




1 


&SH0FF: 


0: 


PI 


Verify 












Restore 




2 


&LWFTN: 


0: 


PI 


Verify 












Restore 




3 


&LWFN4 : 


0: 


PI 


Verify 












Restore 




4 


&LWFFN: 


0: 


PI 


Verify 












Restore 




5 


&LWA01: 


0: 


PI 


Verify 












Restore 




6 


&LWA0 2: 


0: 


PI 


Verify 












Command? 


/E 










READR off 


§ 


1418 18MAY82 







In this example, READR is run using a command string. The 
user has selected the magnetic tape drive and will restore 
the file "SJH::SU" . Since the TT option was not set, the 
restore process will appear on one line. 

; RU , READR , MT , 8 , SE , S JH : ; SU 

REA86 REV. 2226 on @ 1251 18MAY82 with room for 1238 files 
Command? MT,8 
Command? SE,SJH::SU 
Command? /E 
Reading directory 
<<RTE FILE SAVE 1247 18MAY82 1 FILES 2. BLOCKS R=128. REEL= 1>> 
End of directory 

Verify 1 SJH : 0: SU 
Command? <implied /E> 
READR off @ 1251 18MAY82 
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Chapter 4 
Updating the System Disc 



Program READR will replace files on disc with the files on a 

minicartridge saved using the SAVER program. Be sure that READR 

is properly loaded on your system (refer to Chapter 5) before 
beginning . 



Required System Setup 

The disc cartridge to be updated must be a system or peripheral 
file manager cartridge, mounted and properly initialized. 

You should pack the disc cartridge before starting. The UP 
function creates a scratch disc file, purges the old disc file and 
D.RTR does not reclaim that old space unless the new file exactly 
fits in the empty space. After many updates, the new files will 
be at the end of the cartridge and there will be blank areas in 
the middle of the cartridge. The disc cartridge should be packed 
to give READR more room at the end of the cartridge to build its 
scratch files. If this happens in the middle of a large restore, 
use the optional start/finish file numbers for AL and SE command 
to complete the restore operation after a file manager PK command. 



Operations 

1. To begin, enter 

; RU,READR 
READR prompts: 
Command ? 

2. Specify the minicartridge LU: 

MT,n 

For instance enter MT,4 to specify the left CTU of the 
terminal • 
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3. It is recommended to update the disc with all the files on the 
tape, so to restore all file, enter: 

AL 

4. Enter 

UP 
to replace the files on disc with the files on tape. 

5. Override the disc cartridge reference number (CRN) : 

OC,cr 

where cr is your disc CRN. Override the security of the disc 
files: 

OS,sc 

where sc is the security code of the disc files to be updated. 

6. Enter 

and READR will read the first tape file to a scratch disc 
file, compare the tape file with the scratch disc file to 
verify it, purge the old disc file and rename the scratch 
file. READR will follow this procedure for the duration of 
the tape. 

7. When it completes this process, it prompts: 

Command ? 
Enter: 

/A 

to terminate, pack the disc cartridge if necessary and repeat 
steps 1 through 7 for each tape. 

8. If you run out of room, pack the disc, restart READR and 
specify the file number of the next file to be restored (i.e., 
AL:4) rather than the file name. Repeat as needed to complete 
the update process. Ideally, the system disc should have 
empty space equal to or greater than the total files to be 
updated. This avoids the pack requirement. 
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Chapter 5 
Loading READR and SAVER 



READR and SAVER are loaded separately from the relocatable files 
%READR and %SAVER. They can be loaded on-line with the LOADR 
program. They also need $RSLIB, the READR/SAVER utility library. 
Be sure to increase its page requirement to allow room for the 
file name table. 



LOADR commands to on-line load READR: 

Dialogue Comment 

i RU , LOADR 



/LOADR 
/LOADR 
/LOADR 
/LOADR 

/LOADR 



SZ,28 
OP, LB 
RE f %READR 
SE,$RSLIB 



Override program size requirements 
Specify large background. 
Load %READR utility. 
Search the READR/SAVER utility 
1 ibrary. 



EN 



If you are using an RTE system with a revision date code less than 
2101, you must assemble and relocate the entry point $FREV for use 
with the SAVER utility. This entry point is required so that 
SAVER can properly handle extents with Type 1 file access. At 
revision date code 2101, this entry point was included within RTE 
File Manager and will not need to be loaded with SAVER. 

For example, if your RTE File Manager is revision date code 2040, 
assemble this module: 

ASMB,R,L 

NAM $FREV,7 

ENT $FREV 
$FREV DEC 2040 < — Revision code for RTE/FMGR 

END 

and SAVER will save all files with extents properly. 
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LOADR commands to on-line load SAVER. 



Dialogue 
: RU , LOADR 



/LOADR 
/LOADR 
/LOADR 
/LOADR 
/LOADR 
/LOADR 



SZ f 28 

OP, LB 

RE r %SAVER 

SE,$RSLIB 

SE,%$FREV 

EN 



Comment 



Override program size requirements. 

Specify large background. 

Load SAVER utility. 

Search the READR/SAVER utility library. 

Search for entry point $FREV. 



Both READR and SAVER can be loaded as a type 2, 3, or 4 program 
with no SSGA required. Type 4 programs (large background) provide 
the largest area for file storage and therefore the largest SZ 
override. After they are loaded, you should save them as type 6 
files with the FMGR SP command. 

You should load READR and SAVER with a page size override. The 
excess over the program's actual size is to allow room for the 
file-name table. Therefore, the larger the page size, the larger 
the file-name table can be. 

It is not recommended to generate READR and SAVER into an RTE 
system since there will be duplicate subroutine names created. 
$RSLIB should not be generated into RTE for the same reason. Use 
the LOADR SE or LI command for $RSLIB. 
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Appendix A 
Error Messages 



This appendix 
READR programs 



lists all of the error messages for the SAVER and 



SAVER Error Messages 



The following is an alphabetic list of error messages and warnings 
produced by SAVER and explanation or recovery procedures for each 
message. 

Some error messages report that SAVER is waiting. SAVER is 
waiting for you to give a system command to up an EQT or change a 
tape, or it could be waiting for a device to be unlocked. Strike 
any key to enter system breakmode. Now you can BReak SAVER, up 
the EQT, provide a write ring, or place the tape on line. A BReak 
will terminate SAVER, but completing the requested action allows 
SAVER to continue after a short time (approximately 5 seconds) 
delay. 



Message 

Can't save FILE:SC:CR; it is 

a duplicate name. 

new files. n total 

nnn errors found. 

Do you wish to continue? (Y/N) 



Command xx was not recognized 
Use ?? to see command list and 
option setting. 



Directory problem @ 
TK tt, SC cc 



LU nn 



Explanation 

This is just a warning message. 
If running from a runstring, 
SAVER terminates. If not, SAVER 
reports it found no new files, 
but bumps its error counter. 
Answer N to terminate and Y to 
return to the Command ? prompt. 

You entered a command that SAVER 
did not recognize. Enter the 
command correctly, or enter ?? 
if you need help. 

An extent was found prior to a 
main file. The directory may be 
corrupt. If running interactive- 
ly SAVER asks for permission to 
continue. Otherwise, SAVER 
terminates . 
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Directory verify error, SAVER 
aborting . 



EAPOS error nnn. File not 
verified. 

EAPOS error nnn. SAVER 
terminates. 

EOF reached... LU xx is too 
short for this save. This 
SAVER tape is not complete. 



ELOCF error nnn. File not 
verified. 



ELOCF error nnn. SAVER 
terminates. 



End of reel. Please mount next 
tape. Ready with new tape? 
(Yes to continue, No to stop 
the program) . 

nnn Errors found. 

Do you wish to continue? 



SAVER terminates. The directory 
written to tape did not compare 
correctly. 

nnn is the FMP error code. 
Positioning failed during verify. 

nnn is the FMP error code. 
Positioning failed during save. 

There is not enough tape on the 
minicartridge or mag tape reel 
to do this save. Either get a 
larger tape, or select less 
files for this tape. 

nnn is the FMP error code. Read- 
ing the file pointers failed 
during verify. 

nnn is the FMP error code. Read- 
ing the file pointers failed 
during save. 

SAVER filled up one tape reel 

and now requests for the next 

reel. Enter Yes when you have 
mounted the tape. 

SAVER has found errors and asks 
for permission to continue. NO 
terminates SAVER and YES returns 



Error on EXEC call to tape, 
ABREG = xxxxxxxx 



xxxxxxxx is the contents of the 
A- and B-Register at the point 
of suspension for a tape LU EXEC 
call. 



ERROR. . .SAVER will not work with 
LU xx. Change tape LU (Y/N) 



You entered an illegal tape LU. 
(Not driver 23 or 05 or not map- 
ped in current session) . SAVER 
allows you to correct the 
mistake. N will terminate SAVER. 
Y will cause the following 
prompt to be printed: 

New Tape LU is? 
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File already open, SAVER waiting. 



SAVER will wait for the file to 
be closed or for you to enter 
BR,SAVxx at the breakmode 
request. In the case of the 
latter, SAVER reports: 

OPEN error -8 on file FILE 
— DUMMY FILE WRITTEN. 



File name:sc:cr fails to 
verify. Continue with next 
file (Y/N). 



FILE:SC:CR not purged, FMP 
error nnn. 



FILE:SC:CR not purged, 
on group cartridge. 



File is 



FiLE:SC:CR not purged. File is 
on system cartrige. 



LU lock on LU nn failed 
system error = xxxx 



LU xx is locked to another 
program. 



It writes that specific message 
on the tape in the place of the 
file. SAVER continues saving the 
remainder of the specified files. 

After 3 attempts, SAVER allows 
you to skip the unverified file 
to continue saving the remainder 
of the files. 

Error code is the FMP error. If 
you do not have the capability 
(i.e., proper security code.) to 
purge the disc file, SAVER will 
tell you and continue purging 
the remainder of the files (as 
you direct it) . 

You may not purge files on group 
cartridges unless you are group 
(capability of 63) or System 
Manager. SAVER skips purging 
this file and goes on to the 
next. 

You may not purge files on 
system cartridges unless you are 
System Manager. SAVER skips 
purging this file and goes on to 
the next. 

LU nn was to be locked and xxxx 
is the contents of the A- and 
B-Registers at the point of 
suspension for an LU lock re- 
quest. 

SAVER terminates. 
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LU xx is not write enabled. 



SAVER will wait for you to put a 
write ring in the mag tape, or 
move the record switch on the 
minicartridge. It will continue 
testing or will quit if BREAK 
command is issued. 



Magtape LU nn is not defined 
or invalid. 



No files found! 



No files found yet. 



No files selected yet 



No resource numbers available 
to lock LU xx. 



Note: SE,<namr> failed to find 
any files nn times. 



Returns to Command ? prompt. The 
LU number you specified is not 
driver 23 or 05 or in current 
session. Repeat the MT command 
with a magtape LU number. 

No files selected to save and 
either /E, SZ , or LI was issued. 

No files selected to save and 
either /E, SZ, or LI was issued. 

No files selected to save and 
either /E, SZ , or LI was issued. 

SAVER terminates. Reboot your 
system to reclaim resource 
numbers. Notify your System 
Manager. 

The SE command returned files 
found nn times. Informative 
message. 



OPEN error nnn on file FILE — 
DUMMY FILE WRITTEN 



RWNDF error nnn. File not 
verified. 



SAVER tried to save a file that 
was open to another program, so 
it wrote a dummy file which 
contains the error message to 
the tape to keep the directory 
in the proper sequence. This 
file cannot be restored. 

nnn is the FMP error code. 



RWNDF error nnn. Unable to 
redo file. Continue with next 
file (Y/N) 



After trying to reverify a file, 
SAVER is unable to rewind the 
disc file. Enter Y is you want 
SAVER to save the remainder of 
the files. 
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SAVER cannot work with 16 
channel MUX,, This terminal has 
been reset to DVROO. Notify your 
System Manager. 

SAVER cannot save multiple files 
on multiple CTU's. End of job. 

SE, requires a file name. 



Sorry, you do not have the 
capability to purge the disc 
files that were saved. 

SOrt option must be 0-7... 
entry ignored. 

Tape error, system code = xxxx 
SAVER terminates. 



Tape LU xx down. SAVER waiting. 
BReak or UP„eqt. 



Tape LU not defined in your 
session. 



Tape LU xx off line. SAVER 
waiting. BReak or place 
on line. 



Transfer file read error nnn. 

Unable to open transfer file, 
error nnn. 



See your System Manager. SAVER 
can not work with CTUs on 16 
channel MUX (12790A). 



SAVER terminates. 



Re-enter SE and specify a file 
namr . 

SAVER goes on to the next file 
purging as you directed it. 



Enter ?? for more information on 
sort options. 

xxxx is the A- and B-Registers 
at the point of suspension. An 
EXEC call to the tape LU failed. 

SAVER will wait until the tape 
EQT is brought up. Strike any 
key to get system breakmode. 
Bring the EQT up or type BR to 
terminate SAVER. 

SAVER terminates. See your 
System Manager about access to 
the tape LU. 

Bring the tape on-line. SAVER 

will loop back every few seconds 

checking to see if the LU was 

brought on-line. BR may be used 
to terminate SAVER. 

nnn is the FMP error code. 

nnn is the FMP error code. 
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Verify error, data miscompare. 



Verify error, FMP nnn from 
next extent. 



Verify error, unexpected EOF. 



WARNING! File name table size 
of nnn files exceeded! Resize 
the program larger if possible. 



SAVER will retry the save proc- 
ess up to 3 times then ask to go 
on to the next file. If the file 
is on multiple reels, SAVER 
allows you to retry the volume. 
Possible causes are bad media on 
tape or other hardware error or 
the file was changed during the 
save process. 

SAVER was unable to verify an 
extent of the file. Refer to 
message above. 

Refer to the message of verify 
error, data miscompare. Proba- 
ble cause is a corrupted direct- 
ory or physical LU restores 
occurring while saving files. 

You reached the limit of file 
name table. Re-run SAVER and 
specify fewer files for this 
save, reload SAVER with a larger 
size override or use the RTE SZ 
command to increase SAVER's size, 
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READR Error Messages 

The following is an alphabetic list of error messages and warnings 
produced by READR and an explanation or recovery procedure for 
each message. 

Some error messages report that READR is waiting. READR is 
waiting for you to give a system command to bring an EQT up or 
change a tape, or it could be waiting for a device to be unlocked. 
Strike any key to get the system breakmode. Now you can BReak 
READR or bring the EQT up. The BReak will cause READR to 
terminate. Otherwise, READR will loop every few seconds to 
monitor the condition. 



. . .message. . . 

Cannot change magtape LU nn at 
this point. 



. . .explanation. . . 

You may not change the mag 
tape LU now. Terminate and 
re-run READR if you want to 
change it. 



Cartridge not found. 



Command "xx"' not recognized. 
Use ?? to see command list and 
option settings. 

Compare error - data or tape 
length in verify. 



CTU LU nn not ready. READR 
waiting. BReak or UP,eqt. 



FMGR error -032. If in file 
restore phase, use AL to spec- 
if y a new namr or OC to alter 
the cartridge reference for 
all remaining files. 

You entered an invalid com- 
mand. Correct your mistake or 
if you need help, enter ??. 

READR terminates because of an 
error in verify. Possible 
cause is a tape unit problem 
or corrupted directory. 



READR 

sponse 

insert 

strike 

system 

or UP,eqt. 

READR. 



is waiting for a re- 
or some action. Either 
the cartridge tape, or 
any key to get the 
breakmode and enter BR 
BR will terminate 
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CREAT error nnnnnn. name:sc:crn 
Enter HElp,PUrge, ALter, OS, n 
OC,n, or SKip this file? 



Directory read error. 



Duplicate file name. 



EAPOS error nnnnnn. 



ELOCF error nnnnnn. READR 
terminates. 



Error code is the FMP error. 
If running interactively, 
READR allows you to recover. 
See the preceding chapters for 
action. 

READR terminates. READR en- 
countered a record on tape 
that is not a valid filename 
or position. 

FMGR error -002. If in file 
restore phase, use AL to spec- 
if y a new namr, OC to change 
cartridge references or SK to 
skip over this file. 

nnnnnn is the FMP error code 
READR terminates. 

nnnnnn is the FMP error code 
READR terminates. 



End of reel. Please mount next 

tape. 

Ready with next tape? (YES or NO 

to terminate) 



Error; Magtape record is larger 
than READR* s max buffer of nnnn 
words. 

Error on EXEC call to tape. 
ABREG = xxxxxxxx. 



File length mismatch on read. 



This message occurs during 
single file, multiple reel 
saves. READR has encountered 
an end of tape. It rewinds the 
pending tape. Once you have 
mounted the next tape, enter 
YES and carriage return. 

This tape was not created by 
SAVER. 



xxxxxxxx is the contents of 
the A- and B-Register when the 
error occurred. 

READR reached an end of file 
before it expected one. 
Possibly a bad tape unit or 
hardware problem. 
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File number out of range. 



Illegal access to system disc. 



Illegal file name. 



You selected a file number 
larger than the number of 
files on the tape. Try again 
with a different file number 
or select a specific file namr. 

FMGR error -019. You attempted 
to write on the system disc. 
Only the System Manager has 
the capability to write on the 
system disc. Enter AL to alter 
the file namr, or OC,n to 
change the cartridge reference. 

FMGR error -015. Enter AL to 
alter the file namr. 



Illegal type file or 
file size = 



FMGR error -019. Enter AL to 
alter the file namr. 



LU lock for LU nn failed, 
system code = xxxxxxxx. 



LU xx locked to another program. 



Magtape LU nn is not defined 
or invalid. 



No files fitting search namr 
found on this tape. 



Not enough room in program 
to store this tape directory. 
Reload with a larger size (SZ) 
parameter. 

Not enough room on cartridge. 



READR terminates. xxxxxxxx is 
the A- and B-Registers at the 
time of a LU lock call. 

READR terminates. Mag tape LU 
is busy. 

Returns to Command ? prompt. 
The LU number you specified is 
invalid. Repeat the MT command 
with a mag tape LU number. 

Returns to Command ? prompt so 
you can specify another search 
namr. 

READR terminates. Reload READR 
with larger size parameter. 



FMGR error -033. Specify 
another cartridge with 0C,n or 
SK to not restore this file. 



No resource numbers available 
to lock LU nn. 



READF error nnnnnn. 



READR terminates. Reboot your 
system to reclaim resource 
numbers or notify System 
Manager. 

nnnnnn is the FMP error code. 
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READR cannot work with lf>-channel 
MUX. This terminal has been reset 
to DVROO. Notify System Manager. 



See your System Manager 



READR will not work with LU nnnn. Returns to Command ? prompt. 



Record size on tape (nnnn) is 
larger than mmmm allowed for this 
program. 



SE, requires file name. 



Security code mismatch, unable to 
update old file with name:sc:crn. 



Tape error. ABREG = xxxxxxxx. 



Tape LU xx down, READR waiting. 
BReak or UP,eqt. 



Tape off line. READR waiting. 
BReak or place LU xx on line. 



This is a continuation tape 
for a different file. 
Please mount the correct tape. 
Ready with tape? (YES or NO to 
terminate) . 

This tape is not in READR format 
Reel = nnnnnn words. 



nnnn is record size on tape, 
mmmm is the maximum allowed in 
this program. This tape was 
created by SAVER. 

The SE,namr command requires a 
file namr parameter. Refer to 
the discussion in Chapter 3 
about SE,namr if you need help. 

Returns to Command ? prompt. 
READR did not update the disc 
file with the tape file. 

xxxxxxxx is the contents of 
the A- and B-Register when the 
error took place. 

READR will wait until the tape 
EQT is brought up. Strike any 
key to get system breakmode. 
Use BR to quit or bring the 
EQT up. 

Bring the tape unit on line. 
Use BR to quit or place the 
tape LU on line. 

Mount the correct tape and 
then enter YES when ready. 



Tape was not created by SAVER. 
READR terminates. 



This is reel nn. Reel mm should 
have been mounted. 
Please mount the correct tape. 
Ready with tape? (YES or NO to 
terminate) . 



Mount the correct tape and 
then enter YES when ready. 
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This reel was created at tttt 
ddrammyy which is different than 
the previous reel(s) ttt ddmmmyy, 
Please mount the correct tape. 
Ready with tape? (YES or NO to 
terminate) . 

TR,<LU number> not available. 



Mount the correct tape and 
then enter YES when ready. 



Transfer file read error 
FMP nnnnn. 

Unable to create scratch file 
file:sc:crn. Error nnnnnn. 
UPDATE mode cancelled. 



You may not specify a LU 
number as the transfer desti- 
nation. You must use a disc 
file. Refer to the discussion 
in Chapter 3 about TR r namr. 

nnnnnn is the FMP error code. 



nnnnnn is the FMP error code. 
Returns to Command ? prompt. 
If you still want to restore 
this file, specify the same 
search namr without specifying 
UP. Override the cartridge 
reference using OC,n, or when 
receiving the GREAT error -2, 
specify a new namr with AL. Or 
else, terminate READR, purge 
the scratch file, and pack the 
disc. There must be enough 
room to load the file. 



Unable to open transfer file, 
FMP error nnnnnn. 



nnnnnn is the FMP error code. 



Unable to purge file:sc:crn. 
READR terminating. 



READR cannot purge the scratch 
disc file in update mode. 
READR terminates. 



Unable to purge old file, 
error nnnnnn. 



nnnnnn is the FMP error code. 
READR returns to Command? 



Unable to rename scratch file. 
file:sc:crn. Error nnnnnn. 

Unable to replace old file, FMP 
error nnnnnn. Old file remains on 
disc. 



nnnnnn is the FMP error code. 
Returns to Command ? prompt. 

During update mode, READR 
could not replace the old disc 
file with the tape file. No 
updating was done. 
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Unexpected beginning of tape. 
READR terminating. 



READR terminates. Try re-run- 
ning the program. This will 
occur if the terminal is reset 
while using CTUs. 



Use ?? to see command list and 
option settings. 



You entered a command incor- 
rectly. Enter ?? if you need 
help or re-enter the command. 



Warning! Duplicate files on disc 
will be replaced in the UPDATE 
mode. Consider aborting READR 
to backup files if needed. 



Simply a warning. 



WRITF error nnnnnn. 



nnnnnn is the FMP error code. 
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Advanced User and Application Notes 



READR and SAVER differ 
utilities by being fil 
track backup utility (s 
characteristics of th 
content. Thus, adding 
disc LU would be diffic 
FMP calls to obtain 
removable, floppy disc 
layout. By using FMP ca 
is obtained., 



signif ican 
e-oriented 
uch as LSAVE 
e drive, bu 
a few files 
ult at best, 
individual f 
) and withou 
lis, indepen 



tly from previo 
rather than tra 
) is dependent 
t not dependen 
from an LSAVE ba 

SAVER on the 
iles from any 
t regard to any 
dence from disc 



us disc backup 
ck-oriented. A 
on the physical 
t on the data 
ckup to another 
other hand uses 
medium (fixed, 
physical disc 
characteristics 



As a user of READR 
techniques you are 
selection capabili 
security codes for 
save and restore j 
might also consider 
tape, and various 
using the SORT fe 
source, relocatable 
together for easier 
should be used. In 
first, then the fi 
source (&) , reloca 
together. 



and SAVER, you may wish to change 

currently using to take advantage o 
ty with READR and SAVER. By usi 

groups of related files for instanc 
ust those files from or to any disc 

saving just type 5 files (relocatabl 

application software sources on arto 

ature of SAVER, related program par 

, load file, merge file) may all 

handling. In this case, the 'Last 

this option, the last 5 characters 
rst character is used. This means 
table (%) , and command (*) files wi 



the backup 
f the file 
ng unique 
e, you may 
LU. You 
es) on one 
ther. By 
ts (i.e., 
be grouped 

5 1 option 
are sorted 

that the 
11 all be 



Remember, SAVER cannot save the RTE portion of LU 2 since it is 
not a file,, You must backup RTE with a utility such as SAVE, 
LSAVE, or PSAVE. However, unless you patch or load permanent 
programs on LU 2 (type 6 are different than permanent programs) , 
you will not need to save RTE again until a new system generation 
is switched to LU 2. 



B-l 



Advanced User And Application Notes 



Verify Option 

The VERIFY option in both READR and SAVER is set to .TRUE, for 
good reason. There are some media and/or hardware failures that 
may not be detected during the write phase. Without a bit-by-bit 
compare of the original data with the copy, it is not possible to 
determine if the copy is correct until actual use of the files 
begins... and this would naturally be too late. The user is 
encouraged to use the VERIFY option whenever the data being saved 
must be accurate. Consider that the tape you are making could be 
the last tape made before a lightning strike on the power lines. 

Another feature is the automatic retry of a file that failed to 
verify correctly. This is done up to 3 times before SAVER 
terminates. READR and SAVER keep the 'window 1 for file changes to 
aminumum by opening each file one at a time and verifying the 
file immediately. Although some time might be saved by saving all 
files, rewinding and then verifying each file on a second pass, 
the files must remain unchanged throughout the save process. With 
READR and SAVER, this restriction is removed except during the 
actual save and verify of that file. To allow saving open files, 
the file is opened in shared mode during the save process. If the 
file is exclusively opened to another program, SAVER will issue an 
error message and loop every few seconds checking the file's 
status. SAVER can be BR'd to write a dummy file on tape, or the 
exclusively opened file can be closed by the user. 



User Interface 

READR and SAVER detect the BReak state at every loop in the 
program. This allows for controlled termination at any point in 
the program. 

Many of the questions posed by READR and SAVER are in the form 
(YES/NO). The YES/NO questions may be answered as a single 
character (Y or N) or with several characters. Trailing 
characters are ignored. If the question requires either Y or N 
then the question is repeated if some other character is entered. 

To make READR and SAVER more versatile and friendly to the user, 
several features have been implemented. ~One of these is lower case 
character translation. Any READR/SAVER command may be entered in 
lower case and understood. This includes file names, security 
codes, and cartridge references. This can be seen by using the 
batch mode with a command file. Each command from the file is 
echoed after translation to show the progress of the TR file. 

B-2 



Advanced User And Application Notes 




v . „.., *...*.-. v. VJ — ... ~ ... __ ^. __,««>...- _ „« ... „ ng) 

are noted as <null command> and ignored by both READR and SAVER. 
Note that some commands require a parameter separated by a comma 
(i.e., MT,8) while others require only the one command (i.e., 
ECHO). If the required parameter is missing in a runstring, the 
next item is taken as the parameter (i.e., MT,EC) and will produce 
an appropriate error message. 



Update Mode 

The user will find the UPDATE mode for READR somewhat different 
than previous utilities. READR will never replace an old file 
until several steps have been completed successfully. These are: 

1) The file has been loaded onto the requested disc LU with a 
temporary name using the CRETS call. 

2) The file is verified successfully. 

3) Then the old file is purged only if the user gave the correct 
security code in an OC command, or the security code on tape 
matches the file being replaced. 

If any of the items above fail, the old file is left unchanged. 
Since additional space is needed to hold the temporary file, a 
complete update of all files will require the disc LU to have 
approximately twice as much free space as the files being updated. 
When this is a problem, the user may restore files individually by 
specifying a file number (from the directory listing) and then 
stopping READR when a PK command is needed. Remember that disc 
space left by a purged file is not reused unless the file being 
created is exactly the same size. 
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File Space 

SAVER does not actually read the file sequentially. Instead, the 
files are opened in type 1 access mode. This means that the 
individual records are left in their 'native 1 state. For variable 
length records, the length word, the data and the trailing length 
word are saved as a unit. The effect of this technique is to save 
all disc space requested by the directory entries even though the 
last extent may not be full. Thus, a restored file (where the 
original had extents) will have no extents (always true with 
READR) but with a file size that may be longer than necessary. 
However, a simple transfer or edit of the file can remove the 
extra blocks. The user need not be concerned about the extra 
space. It was there in the original file and merely appears in a 
different form (no extents) in the restored file. 



Tape Utilization 

SAVER saves files so that a physical record on tape may contain 
many logical records. This is done for efficient utilization of 
tape. The typical FMGR command to STore a file on tape creates 
records exactly as long as the original (variable length) . This 
is typically 5 to 20 words or 10-40 bytes. At 800 bytes per inch 
(magnetic tape) this would be 1/80 to 1/20 of an inch to store the 
records. However, every record requires an inter-record gap of 
2/3 inch. If all records were 10 bytes in size, only 2% of the 
tape will contain data. Even at 80 bytes (1/10 inch) , the 
utilization is still only 20%. It is apparent that the longer the 
record (for tape) , the better the tape usage. 

SAVER makes the best use of tape by writing 4096 byte blocks 
whenever possible. This works out to about 90 to 95% tape 
utilization without approaching the limit for error detectability . 
CTUs in the terminal are similarly more efficient but are limited 
to 256 byte records due to terminal firmware constraints. 
However, SAVER comes very close to the 110,000 byte storage 
capacity on a CTU minicartridge. 
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SAVER predicts tape utilization based on nominal physical 
adjustments for the 3 tape formats (800/1600 bpi magnetic tapes 

from magnetic tapes in that only a 
Thus, 800 bpi for CTUs is only 1/8 
9 track tape drives. The following 
computations used in SAVER: 



and 800 bpi CTUs) CTUs differ 
one track record head is used, 
of the same data capacity for 
is a summary of the tape usage 



ITEM 



BOT to first data 
Each data byte 
Inter-record gap 
Inter-file gap 



800 



3.0000 
.0012 
.6200 

5.5000 



1600 

7.0000 
.0006 
.6700 

3.0000 



CTU 

3.0000 
.0100 
.8800 

3.5000 



inches 



For example,, a 256 byte record would require .307" 
bpi, .154" at 1600 bpi and 2.56" on a CTU. 
inter-record gap, the final results for a single 
.927" for 800, .824" for 1600 and 3.44" for a CTU. 



for data at 800 
By adding the 
record save are 



The table sh 
costly. The 
overhead. The 
but are subj 
standard. In 
during a writ 
the record, th 
record rewritt 
10 times, an 
SAVER knowing 
with this long 



ows that separating records 
larger the record, the small 
se values are Industry stand 
ect to some tolerances all 
addition, if a tape error is 
e, the tape will be backspac 
en an erase forward of 4 inch 
en in the new area. Since th 
inter-record gap could be 4 

this fact. The tape would 

gap. 



and files is indeed 
er the effect of this 
ard for magnetic tapes 
owed within the ANSI 
detected by the driver 
ed to the beginning of 
es is performed and the 
is may take place up to 
inches long without 
still be readable even 



Tape Format 



The actual tape format is given below. The 
the directory, followed by 1 to n files, 
record is a title and will be 80 bytes long 
of SAVER may have slightly shorter rec 
compatible with READR) . The header and the 
using FMGR commands (i.e., LI, ST, DU) and 
LOCAL by the terminal's READ key. The heade 
date and time that SAVER started the job, th 
number of blocks needed to fully restore th 
finally the block size and reel number. Each 
file namr and numeric position in the file 
terminated by 1 file mark. 



first file is always 

The first directory 

(pre-release versions 

ords but these are 

directory may be read 

for CTUs, listed in 

r record contains the 

e number of files and 

e files on tape, and 

directory entry is a 

The directory is 
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(bytes) 

Start Finish Length Contents 



-Directory Header 

111 Blank 

2 16 15 Text: <<RTE FILE SAVE 

17 17 1 Blank 

18 21 4 Time of Save (HHMM format) 
22 22 1 Blank 

2 3 29 7 Date of Save (DDMMMYY format) 

30 30 1 Period 

31 36 6 Number of files on tape 

37 37 1 Blank 

38 43 6 Text: FILES. 

44 50 7 Number of blocks (128 words) needed 

to restore all files on the tape. 

51 51 1 Period 

5 2 57 6 Text: BLOCKS 

5 8 59 2 2 blanks 

6 61 2 Text: R= 

6 2 65 4 Max block size on tape in words 
66 68 3 Period and 2 blanks 

69 73 5 Text: REEL= 

7 4 76 3 Reel number 
77 78 2 Text: » 

79 79 1 Revision level for SAVER 

80 80 1 Text: > 

-Directory entry: 

16 6 File position on tape (0=directory) 

7 7 1 Blank 

8 13 6 File name (6 characters) 

14 14 1 Colon 

15 20 6 Security code 

21 21 1 Colon 

22 27 6 Cartridge Reference number 

28 28 1 Colon 

29 34 6 File type 

35 35 1 Colon 

36 41 6 File size (+blocks, -chunks) 

42 42 1 Colon 

43 48 6 Record size (Type 2 files) 
49 80 32 Blanks 

Each file has 1 directory entry. The directory is terminated with 
a file mark (tapemark) . Next, the actual file is stored. For 

CTUs r all blocks will be 256 bytes. For magnetic tapes, the 

blocksize is 4096 bytes unless the rest of the file is less than 
4096 bytes. Then the record size will be a multiple of 256 bytes. 
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The format of the tape used by the READR/SAVER programs follows: 



+ + 

Beginning of tape 



Directory file 



data file 1 



data file 2 



data file N 



file gap 



file gap 



file gap 



file gap 
file gap 



+ + 

(end of data) 
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Format of the directory file is as follows 



record 1 
(header) 
(see below) 



record 
entry for 



2 

data 
file'l, ASCII 
256 bytes max. 
80 bytes typical 



record 3 
entry for data 
file 2, ASCII 
256 bytes max. 
80 bytes typical 



record 


N 


entry for 


data 


file N-l, 


ASCII 


256 bytes 


max. 



80 bytes typical 



file gap 



record gap 



record gap 



Record 1 is the Header record of ASCII 80 bytes. It contains 
the time of creation of the tape, the number of files on the 
tape, the total number of RTE blocks (128 words) in all the 
files, the record length in words for the packed data file 
records, and the reel number. 
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To give users of non-RTE-IVB systems usage of SAVER tapes, the 

following program will run on any RTE2/3/4A, RTE-L/XL, or RTE-A 

system with an 8K partition. It does no error checking at all, 

but will read any READR tape. The user must manually position the 

tape to the desired file. If file n is desired, then n 
file-forward (CN,lu,FF) commands must be given. (Tape starts at 
bottom. ) 

FTN4,L 

PROGRAM GETRS(3, 99) ,GET FILE FROM READR/SAVER TAPE REV. 2012 
C 

C_ . . , 

C THIS PROGRAM WILL READ ANY FILE FROM A TAPE WHICH IS IN THE 
C READR/SAVER FORMAT. IT IS A QUICK AND DIRTY WAY JUST TO GET 
C READER OFF THE TAPE TO GET THE REST OF THE FILES. THINK OF 
C IT AS A BOOTSTRAP. IT DOES NO ERROR CHECKING AT ALL. 
C- . 

c 

C FIRST POSITION TAPE TO BEGINNING OF FILE WITH CN REQUESTS, THEN 

C RUN WITH — > RU,GETRS,MT,BL,TYPE 

C 

C MT IS THE LU OF THE MAGNETIC TAPE OR MINICARTRIDGE 

C BL IS THE NUMBER OF BLOCKS IN THE FILE, AS SHOWN IN THE 

C DIRECTORY AT THE FRONT OF THE TAPE. 

C TYPE IS THE FILE TYPE TO BE CREATED (MUST MATCH ORIGINAL FILE) 

C 

C l!!!i!!!!!!!!!!!!!!ill!!!!ill!!i!!ll!l!i!iil!!il!l!!i!!!!!ll!l!i 

C • I TAPE MUST BE MANUALLY POSITIONED TO THE START OF THE FILE ! ! 

C !!!!!!il!llll!l!!!!!!liillll!i!!!!l!!!!illi!l!!!!!Il!ill!l!!!!!i 

C ALSO, FILE WILL ALWAYS BE NAMED »******». MUST RENAME AS NEEDED. 

C 

DIMENSION IBUF(2048) ,IDCB(144) ,IP(5) ,ISIZE(2) 
C 

C PICK UP TAPE LU, FILE SIZE 
C 

CALL RMPAR(IP) 

ISIZE(1)=IP(2) 

ISIZE(2)=0 

MT=IOR(100B,IP(1) ) 

IF(IP(3) .EQ.O) IP(3)=5 
C 

C TRY TO CREATE A FILE TO HOLD IT 
C 

CALL PURGE(IDCB,IERR,6H******) 

CALL CREAT(IDCB,IERR,6H******,ISIZE,IP(3) ) 
C 

C FORCE TO TYPE 1 FILE 
C 

IDCB(3)=1 
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C READ THE TAPE 
C 

DO 100 1=1,1000 

CALL EXEC(l,MT,IBUF r 2048) 

CALL ABREG(IA,LEN) 

IF(LEN.EQ.0)GO TO 9000 
C 

C WRITE THE DATA TO THE FILE 
C 

CALL WRITF(IDCB,IERR,IBUF,LEN) 
100 CONTINUE 
C 

C CLOSE THE FILE 
C 
9000 CALL CLOSE (IDCB) 

CALL EXEC(2,1,20HFILE ****** CREATED. , -20) 

END 



Cartridge Tapes 

The CTUs need some special considerations in that they are part of 
a subsystem (terminal, CTUs and possibly a printer or HPIB 
device) . When the terminal is used for special purpose editing 
(such as EDIT/1000 or forms mode), internal straps are set or 
cleared as needed by the application. When CTUs are used, these 
straps may create an error condition for CTU operation. To 
overcome this problem, SAVER and READR both configure the straps 
as normally needed for proper CTU operation. The driver is asked 
to update status so that the terminal and driver match states. 
The update status call is not compatible with the 16-channel 
multiplexer driver and will reset the driver to type 00. SAVER 
and READR are therefore not compatible with the older MUX product. 

Terminals also treat the CTUs differently at a record length of 
256 bytes. Therefore, a tape retry may cause a record to be 
recorded which places the terminal in an 'I/O ERROR A 1 state when 
reading back. The tape should be re-recorded and if the error 
repeats, the tape should not be used for SAVER files. This 
applies to any program using 256-byte records. In addition, the 
data recorded in type 1 access will contain binary data and the 
Std Async Datacomm interface (02640-60086) will not support the 
CTU with binary data at high baud rates. Either the GP Async 
interface (02640-60089) may be used at 4800 baud or the Enhanced 
Datacomm interface (02640-60239) may be used at any baud rate. 
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File Access Rights 

Extended files (files using double integer record numbers) are 
restored as extended files (size = -chunks) . File access is 
controlled by the level of the user's login rights. If the user 
is not a group manager (i.e., level 63), files on group or system 
mounted LUs may not be purged by SAVER'S purge phase, and 
read-only files (negative security codes) on group or system 
cartridges may not be saved at all. Only the System Manager can 
save or update files stored on system cartridges where the files 
are read-only. If the user does not have purge rights to files 
saved from a given disc LU, the security codes are not saved on 
the directory (i.e., set to zero). 



File Comments 



One of the useful techniques in documenting a file save tape is to 
make the TR file the first file saved on tape, and to include 
numerous comments in the TR file. This way, load instructions, 
application info and operations notes can become part of the save 
tape. If the tape directory is to be sorted, be sure that the TR 
file has a name that places it first in the sort sequence. In 
ASCII, the ! and " come before every other file naming character. 
If a sort on the last 5 characters is done, name the file ""INDX 
or similar name that will place the file at the beginning. Be 
sure that the TR file selects itself too. The following is an 
example of a TR file with comments for documentation. 

* 

* index to programs 
* 

SE,""INDX: ;SP 
* 

* Database save. .. 3/22/81, updated as of 3PM 
* 

SE,-DATCP: :DB 
* 

* Load the following programs with SSGA access 
* 

SE,-DS : :DS 

/E 
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One last note about runstrings. The NO option may not be used as 
the first parameter. RTE considers RU, SAVER, NO VE as a schedule 
NOW option and throws away the first parameter up to the next 
comma. To avoid this problem, use NOT VE or place NO VE as some 
parameter other than the first. This could even be done by using 
2 commas following the program name. SAVER and READR ignore 
adjacent commas and RTE will not absorb any data beyond the second 
comma • 
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advanced user, B-l 
AL command, 3-4 
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Directory, 1-1, 3-6 
disc cartridge, 4-1 
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end of command, 3-11 
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M 
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options sort, 2-2 
OS command, 3-5 
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override command, 3-8 



Page requirements, 5-1 
PU command, 2-7 
purge saver, 2-2 



R 

READR 

File restoration phase, 3-1 

file selection phase, 3-1 
READR command 

/A, 3-11 

/E, 3-11 

AL, 3-6 

and file selection phase, 3-1, 3-6 

CO, 3-6 

EC, 3-6 

LI, 3-6 

MT, 3-7 

OC,n, 3-8 

OS,n, 3-8 



SE,namr, 3-8 
TR,namr, 3-10 
TT, 3-10 
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UP, 3-10 

VE, 3-11 
READR File restoration phase, 3-12 
run READR, 3-3 



S 



SAVER 

Command and file search phase, 2-1, 2-6 

Error Messages, A-l 

File purge phase, 2-2, 2-13 

File save phase, 2-1, 2-12 

Scheduling, 2-2 
SAVER command , 

/A, 2-11 

/E, 2-12 

CO, 2-6 

EC, 2-6 

ER, 2-6 

LI, 2-6 

MT, 2-6 

PU, 2-7 

SE,namr, 2-7 

SO, 2-9 

SS, 2-10 

SZ, 2-10 

T6, 2-11 

TR,NAMR, 2-10 

TT, 2-11 

UN, 2-11 

VE, 2-11 
Scheduling 

READR," 3-2 

SAVER, 2-2 
SE command, 3-4, 
SE,namr command, 
sort options, 2-2, 2-9 
Sorting files, B-l 
SS command, 2-10 
System requirements, 1-2 
system setup required, 4-1 
SZ command, 2-10 
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tape, 3-7 

Tape format, B-4, B-5 
Tape utilization, B-4 
terminal command, 3-10 
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TR,namr command, 3-10 
transfer command, 3-10 
TT command, 2-11, 3-10 



U 



UN command, 2-11 

UP command, 3-5, 3-10, 4-1 

update command, 3-10 

Update mode, B-3 

Updating the system disc, 4-1 

Updating files, B-3 

user interface, B-2 



V 



VE command, 2-11, 3-11 
verify command, 3-11 
Verify option, B-2 
Verifying files, B-2 
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T h e R E fl D R p r o g r a m h a s t w o m a . j o r p h a s e s , t h e f i r s t o f w h i c h i s a n 
i n t e r ac t i >■.■> e d e f i n i t i o n p h as e , w h e r e t h e u s e r d e f i n e s t h e w ay t h at. R E fl D R 
t o r e t r i e v e t. h e f lies. fl t t h e e n d o f t h i s p h as e , a d i r e c t o r y i s r e ad 

the tape and stored in a table in memory. 

T h e s e c o n d p h as e i s t h e r e s t o r e p h as e . R E Fl D R u s e s t h e d i r e c t o r y i n m e m o r y 
to position the tape and read files from the tape and store them on disc. 
This phase can be run interactively or in a batch mode. 



T ab 1 e o f i n t e r ac t i v e c o m m an d s . 

.•-fl ABORT 

This command is used to abort the program. 

VE VERIFY 

This is a command to disable the verify of the tape. REfiBR wi 1 1 
do a complete verify of al 1 f i 1 es unless this command is given. 

MT,n MAG TAPE LU CHANGE 

T h e d e f au 1 1 L U f o r t h e t ap e i s 8 . T h i s c o m m an d all o w s t h e u s e r 
t o s e 1 e c t s o m e o t h e r v a 1 u e , w h i c h c an b e t h e L U o f e i t h e r a 797 6 
d r i v e o r o n e o f t h e m i n i - c ar t r i d g e L I J '' s o n a 264 ! :: ! t e r m i n a 1 . 
H o t e t h a t R E fl D R d o e s n o t s u p p o r t t h e u s e o f t h e m i n i - c a r t r i d g e 
drives on a multi -point terminal, as they do not have independent 
RTE LU's. 

T T T e r m i n a 1 T y p e 

T h i s p ar am e t e r s e 1 e c t s t h e m an n e r i n u h i c h o u t p u t t o t h e t e r m i n a 1 
is done. The default mode is CRT mode. In this mode, much of the 
output to the terminal is done without a linefeed at the end of the 
line. T h e o t h e r m o d e o f t e r m i n a 1 o u t p u t i s h ar d c o p y . T h i s m o d e 
does linefeed at the end of the line. 

LI LIST f i les 

T h i s c o m m an d c au s e s t h e t ap e d i r e c t o r y t o be 1 i s t e d t o y o u r t e r m i n a 1 
as the directory is read. Default is no list. 

T h i s u s e f u 1 i f t h e d i r e c t o r y i s s h o r t . I f i t i s t o o 1 o n g t o f i t o n 
the crt screen, the first file can simply be listed to a pr inter- 
by the FMGR, as the first file is in -'dump"' format. (it is the only 
one wh i c h is 1 i st ab 1 e . > 
ALL f i 1 es mode 

T h i s p ar am e t e r i n d i c at e s t h at y o u w i s h t o r e s t o r e all t h e f i 1 e s o n 
the tape to disc. This mode is not interactive. 
UPDATE mode 

The normal mode of operation of RE ADR is to merge files from the 
t ap e w i t h f i 1 e s a 1 r e ad y p r e s e n t i n t h e s y s t e m . I n t h i s m o d e , i f 
READ R e n c o u n t e r s an e r r o r w h e n i t at t e m p t s t o r e s t o r e a f i 1 e 
(. s u c h as d u p 1 i c at e f i 1 e n am e , F M P - 2 > , i t s i m p 1 y r e p o r t s t h e e r r o r , 
skips the f i le on the tape and tries the next one. 
The assumption in this mode is that the files on the tape are 
older than the ones on disc. This is the mode which is best when 
r e s t o r i n g a b a c k - u p t a p e . 

I f t h e f i les o n t ap e ar e m o r e r e c e n t , f o r i n s t an c e u p d at e d s o f t w ar e , 
then you would want the f i les on tape to take precedence over the ones 
on disc. The Update command allows this method of file retirieval. 
In this mode, if a file already exists on disc which has the same name 
as a f i 1 e t h at R E A D R is at t e m p t i n g t o r e s t o r e , READ R w ill c r e at e 
a scratch file, restore and verify the file, then purge the old file 
and rename the scratch file, — but only if no errors on verify! --. 

EC ECHO 

This parameter is used to enable the echoing of the tape position 
as RE ADR seeks files on the tape. This is done to prevent that 
■'' w h at is it d o i n g n o w ? '' f eel i n g . D e f au It is e c h o e n ab 1 e d . 

C , n v e r r i d e C a r t r i d g e n u m b e r 

This f 1 a* 1 is used specify that the f i les be restored to a different 
c ar t r i d q e r e f e r n c e n u m b e r t h an t h e o n e t h e y w e r e s a v e d w i t h . T h i s 
is especially needed when transporting files from one system to 
another, as the two systems may not have any U.R.N, s in common. 
The numeric parameter may be either positive for C.R.N, or- negative 
for disc LU or zero to use any disc with enough room for the file. 
If OC is entered without a parameter following it, it cancels the 



ALL 



UP 



. . ..-. + ..-. n .-I .-, . 



. ..-, ,-i + l- ^ J.'' -, 1 



K ■=. i.-. ■=. ■= + 



'•,' a 1 u e s g i v e n o n t h e t ap e . 
S , n v e r r i d e S e c u r i t y c o d e 

T h i s c o m m an d i s u s e d t o o v e r r i d e t h e s e c u r i t y c o d e t h e f i les h ad 

w h e n t h e y w e r e s ay e d . T h is all o w s f o r e as y t r an s p o r t ab i 1 i t y a 1 s o . 

The numeric parameter can be pos., neg», or zero. 

I f n o p ar am e t e r i s g i y e n , s e c u r i t y c o d e o y e r r i d e i s c an eel 1 e d . 
.-•' E E H B o f d e f i n i t i o n p h as e 

T h i s c o m m an d i s u s e d t o 1 e ay e t h e 1 n t e r ac t i y e d e f i n i t i o n p h as e . 

When this command is given, RE ADR will read the first file on the 

t ap e t o b u i 1 d t h e i n m e m o r y d i r e c t o r y . 

R E A B R c an a 1 s o g e t i t •■' s r o m m an d s f r o m t h e r u n s t r i n g w h i c h s c h e d u 1 e d 

t h e p r o g r am . F o r e x am p 1 e , R U , R E Fi B R , C , 5 , M T , 2 2 , fi L L w o u 1 d c au s e t h e 

p r o q r am t o r e s t o r e all t h e f i 1 e s o n t h e t ap e o n L U 22 t n a d i s c w h i c h h a 

c ar t r i d g e r e f e r e n c e n u m b e r 5 . 

T h i s h as t h e p o s s i b i 1 it y o f r e s t o r i n g g r o u p s o f f i 1 e s w i t h n o o p e r at o r 

i n t e r y e n t i o n . 



F o r a 1 1 o f t h e i n t e r ac t i v e c o m m an d s t h e e f f e c t o f t \ 
c o m m an d c an b e c an eel e d b y r e - i s s u e i n g t h e c o m m an d . 



For example, if you 
t again wi 1 1 re-enabl 



3 t o q q 1 e t h e s t at e o f t h ■ 



t y p e V E w h i c h w o u 1 d d i s ab 1 e t- ap e y e r i f y , e n t 
the verify. The action of the commands is t 
p r o g r am f 1 ag s . 

FILE RESTORE PHASE 
T h e f i r s t t h i n g t h at READ R d o e s w h e n i t e n t e r s t h e r e s t o r e p h as e i s t c 
p r i n t t h e h e ad r e r r e c o r d f r o m t h e d i r e c t o r y o n t h e t ap e . T h i s r e c o r d 
has the time that the save was done, the number of fi les on the tape, 
the total number of blocks in all the files and the record size in wor 

,-. £' t !.-■ c + =i V-i i=- ►-■ ■=■ i- i-i !•-• H ■= 



t h e t o t a 1 n u m b e r o f b i o < 
o f t h e t ap e r e c o r d s . 
If LI w as s p e c i f i e d , t h i s 
t h e f i 1 e s o n t h e t ap e . 



i n al 1 
s w ill be f o 1 1 o w e d b y a 



ds 



listing of the NAMRs of 




ni_ «_ iJIII 111-a.rl'J w ! I i f- 1 r l ri'.- '.■ r 1 1 nnnr-, '.• i i -=l '.■ i ■-. i_ i i j_- i ■■. i _■ :■ ; y i ny '.-■-■ •- < •= -^ ■■ ■ •= ■=■■ ■ ■ *— " •-- ■■•—>> 

allow the user to input a new HAMR to try. This a temporary change for 

t h e c u r r e n t f i 1 e o n 1 y . T h e u s e r n e e d s o n 1 y i n p u t t h e s u b p ar am t e r s t h at 

ar e t o b e c h an g e d . F o r e x am p 1 e , g i v e n "' '. = B E " , R E A B R w o u 1 d c h an g e t h e 

c ar t r i d q e n u m b e r w i t h o u t af f e c t i n g t h e n am e o r s e c u r i t y c o d e p ar am e t e r s . 

The OC and OS commands allow a permanent alteration of the security code 

and cartridge numbers for all the remaining files (see OC and OS above). 

T h e 1 as t o p t i o n , I G n o r e , d o e s j u s t t h at , g o i n g b ac k t o t h e p r o m p t f o r a 

f i le HAMR. 

I f ■'' — ■' i s e n t e r e d , R E A B R w ill r e t u r n t o o h as e o n e o f t h e p r o q r am . 

I f a z e r o 1 e n q t h r e c o r d ( c o n t r o 1 B f o r B V R 8 6 d e v i c e s , o r c ar r i ag e r e t u r n 

w i t h n o o t h e r i n p u t f o r B V R 6 5 d e v i c e s > i s i n p u t , R E A B R as k s : 

"Bo you wish to quit?''; any response other than NO is taken as affirm at 

(. i n c 1 u d i n g z e r o 1 e n g t h r e ad > . 



F o r m at o f t h e t ap e u s e d b y t h e R E fl I' R .■■■' S Fl V E R p r o g r am s : 
EOT 

D i r e c t o r y f i 1 e 

= = = file g ap 

data file 1 

: = file g ap 

d at a f i 1 e 2 

: = = file g ap 



f i 1 e H 





et 


c • 




dat 


a 


= = 


f i 1 


£■ 


,™ 


T i i 


e 


F> 


'j r iti a 


Lt 


= = 


f i 1 


e 



gap 



.■■ i-i T fl IS 



u v i.' ill ■a.i ■ t-. >zi \ L- i '_■ / 



y dp \ y i r-. i\ .-■ u r • c '_• v 

o f t h e d i r e c t o r y f i 1 e : 
gap 

r e c o r d 1 , H e ad e r r e c o r d , Fl S C I I 6 8 b y t & s , c o n t a i n i n q t h e t i m e o f 
creation of the tape, n umber of f i 1 es on the tape, 
t o t a 1 n u m b e r o f R T E b 1 o c k s < i 2 8 w d s ■■■■' 256b y t e s ;< i n all t h e 
f i 1 e s , an d t h e r e c o r d 1 e n g t h < w d s > f o r t h e p ac k e d d at a 
f i 1 e records. 
— re c o r d g ap 

r e c o r d 2 , F i 1 e e n t r y , ASCII 4 b b y t e s , c o n t a i n i n g an i n d e x n u m b e r 

■■1 to H>, and the RTE HflMR of the data file. The order 

of the file entry NRMR's is the same as the order of th 

d at a f i 1 e s o n t h e t ap e . 
■ - r e c o r d g ap 



e t c 



r e c o r d H , e n t r y f o r d at a f i 1 e H 
f i 1 e g ap 



F o r m at o f a t y p i c a 1 d at a f i 1 e : 
: file g ap 



r e c o r d i , 1 9 2 4 w d s 
record gap 
r e c o r d 2 , 1 Q 2 4 w d s 

r e c o r d g ap 
e t c . 



d at a r e c o r d s ar e i m ag e s o f t h e d i s c s e c t o r s 
p ac k e d 8 s e c t o r s p e r r e c o r d f o r a t o t a 1 o f 
1Q24 w o r d s p e r r c c o r d . T h e 1 as t r e c o r d w i 1 1 
b e w h at e v e r s i z e i s n e e d e d t o c o r _ i t a i n t h e 
r e m a i n d e r o f - 1 h e f i 1 e w h e n 1024 w o r d b 1 o c k s 
ar e n o t n e e d e d . 

The record size will always be a multiple of 
128 w o r d s , as o n 1 y w h o 1 e s e c t o r s ar e s aw e d , 
e w e n i f t h e f i 1 e 1 o g i c a 1 1 y e n d s i n t h e m i d d 1 e 
of a sec t or = The m i n i fuun's si ze of a dat a f i 1 & 
i s a s i n g 1 e r e c o r d , 12 8 w o r d s 1 o n g . 
f c o u r s e , si n c e t h e m i n i - c ar t r i d g e s h aw e a 



■ t^ 



words, all records 



w ill be 128 w o r d s . 

The records on the tape are exact images of 



+ ■ -■!•-■ t I li 



anH .ahnkjp 



■ - re c o r d - g ap 

f i n a 1 r e c o r d , 
128 to 1 8 2 4 w o r d s 



= = = file g ap 



1 e n g t h s an d 
z e r o 



f i les w ill c o n t a i n t h e R T E r e c o r d 1 e n g t h 
a 1 1 o t h e r i n t e r n a 1 s t r u c t u r es, i n c 1 u d i n g 
1 s=- n q t h r e- c o r d s . T h i s m ak e s t h e r e s t o r e 
o p e r at i o n v e r y e f f i c i e n t . 



The SAVER program has three major phases, the first of which is an 

> _ .-■■,. _ t, ab 1 e i s bu i I t i n memory 



i n t e r ac t i v e s e ar c h p h as e , w h e r 

. h e f i les 



a f i 1 e name 

that are to be sav> 
d i r e c t o r y . 



s e c o n d p h as e 



containing the names of the files that are to be savec 
T h e f i 1 e is b u i 1 1 b y s e ar- c h i n g t h e F M P f i 1 e d i r e c t o r y . 

is for the user to specify a mask HflMR which the program uses t. o t i no t i \ 

~" ' ' ery similar in operation to the 



i n t h e 

T h e b as i c m e c h an i s m 

to f i nd f i 1 es 



m u: 




T ab 1 e o f i n t e r ac t i y e c o m ni an d s . 
.-fl RBORT 

T 
VE Verify 

T 



EORT 

h i s c o m m an d i s u s e d t o ab o r t t h e p r o g r am . 

e r i f y 

verify of the tape. SAVER will 
ctory and all files unless 



e r i t y 

his is a command to disable the yeri 
d o a c o m p 1 e t e y e r i f y o f t h e t ap e d i r e 
t h i s c o m an d is g i y e n . 

K<i-ii- TO OCT III r-UClkllT 



1 s c o m m an d all o w s t h e u s e r 
c an b e t h e L U o f e i t h e r a 797 8 



'.■ n i _• '_ u hi arm i — ■ y i ■■■•■= i i • 

t-1T, 1 MAG TRPE LU CHRHGE 

The default LU for the tape is 8. Tl- 

t o s e 1 e c t s o m e o t h e r y a 1 u e , w h i c h c ar 

dr i ye or one of the m i n i — cart r 1 dge LU s- uri ■=. cv-r,-, •-.■ = i m > ■■ >■=>. ■ . 

H o t e t h a t S fl V E R d o e s n o t s u p p o r t t h e u s e o f t h e m i n i - c a r t r i d g e 

Irives on a multi -point terminal, as they do not have independent 

:TE LU-'s. 



T6 



Hi 

d r i y e < 

RTE LU-s 

T e r rr i i n a 1 T y p e 

This 

o u 

line. T h e 

does 1 i nef eed 

T y p e 6 

This 



r in i rid i i >• f-"= 

i s p ar am e t e r s e 1 e c t ■=. t, h e m an n e r i n w h i c h o u t p u t t o t h e t e r m i n a 1 

d o n e . T h e d e f au 1 t m o d e i s C R T m o d e . I n t h i s m o d e , m u c h o f t h e 
t p u t t o t, h e t e r m i n a 1 i s d o n e w i t h o u t a 1 i n e f e e d at t h e e n d o f t h ► 
n e . T h e o t h e r m o d e o f t e r m i n a 1 o u t p u t i s h ar d c o p y . T h i s m o d e 
e s 1 i n e f e e d at t h e e n d o f t h e 1 i n e . 



T h i s p ar am e t e r i s u s e d t o e n ab 1 e s ay i n g t y p e 6 files. T h e d e f a 

is to not save type 6 files, as they are not transportable from 

s y s t e m t o s y s t e m . fl d d i t i o n a 1 1 y , S fl V E R n e y e r at t e m p t s t o s ay e 
type f i les. 



type f i les 
ECHO 

ieter is used to enable the echoing of the f 
>r. The default is no echo. 



SE 



T h i s p ar am ■_■.••_. . _• ■--._■ — . - ... — . - 

to the user. The default is no echo 

SEARCH 

T h e f o r m at o f t h 

This is a s p e c i a 1 



e s e a 



ar c h e s 



s e ar c h c o m m an d is S E , F I N fl M : S C : C R : T Y : U M S C . 
„ ( use of the RTE HflMR format, where the parameters 

h ay e t h e f o 1 1 o w i n g u s e s : 

F I H fl M file n am e , 8 t o 6 c h ar ac t e r s 1 o n g , w h e r e e ac h c h ar ac t e r 

follows the RTE file naming c onyent i ons as giyen in the FMGR 

d o c u m e n t at i o n , w i t h t h e e x c e p t i o n t h at an y c h ar ac t e r p o si t i o n 

can be held by a '" - "' to denote that this position is a don't care 

pos i t i on i n t he f i 1 e name c ompar i son . 

If no name is giyen (:sc:cr for example), it is equivalent to 

a name of ' '' . 

:, C s e c u r i t y c o d e , t w o a 1 p an u m e r i c c h ar ac t e r s o r a n u m b e r , 

e i t h e r d e c i m a 1 o r o c t a 1 . I f a s e c u r i t y c o d e is g i v e n , t h e n t h e 
ab s o 1 u t e v a 1 u e o f t h at c o d e w ill bee o m p ar e d t o t h e ab s o 1 u t e v a 1 u e 
of each file to determine if the file is to be saved. If no securit 

i- i-i H ■=■ -i ■=. i-i i i.j i=- f-i i' n .=1 m i=- : : r r +"' n r- p ':•:■ .=i m ti 1 i=- ''.> . t. h i=- n .3. 1 1 •=. e C U r i t V C O d e S W i 1 1 



b e a c c e p t e d . H o t e t h a t f o r s y s t a- m s o t h e r t h a n R T E - I V b , t h e 

s y s t e m m as t e r s e c u r i t y c o d e m u s t b e g i y e n as t h e 4 1 h p ar am e t e r t o 

a 1 1 o w s av i n g n o n - s p e c i f i e d s e c u r i t ; : ,' c o d e s . 

C R c ar t r i d g e r e f e r e n c e , i f p o s i t i y e w ill r e s t r i c t f i 1 e s t o 

t h e d i s c w i t h t h e g i y e n c ar t r i d g e r e f e r e n c e n u m b e r , I f n e g at i y e 
t h e L U o f t h e d i s c w ill be u s e d as t h e m as k . I f C R n o t g i y e n , 
o r i f z e r o , all d i s c s w ill be ac c e p t e d . 

U M S C s e e s e c u r i t y c o d e d e f i n i t i o n . 

PU PURGE 

T h e p u r g e f 1 ag i s s e t- b y t h i s c o m m an d . H o i m m e d i at e ac t i o n o c c u r s 
as this is a flag to enter the purge mode after the files are saved 
t o t ap e , N o t e t h at t h e p u r g e m o d e w ill n o t b e e n t e r e d i f S R V E R 
i s n o t r u n n i n g i n t e r ac t i y 1 y , i f t h e r e w e r e e r r o r s d e t e c t e d d u r i n g 
t h e y e r i f y p h as e , o r i f t ap e y e r i f y w as d i s ab 1 e d . 
TR,HfiMR 

S fl V E R c an t r an s f e r t o a f i 1 e c o n t a i n i n g c o m m an d s . T h e f o r m at o f 
the commands is the same as if they were being entered by the user. 



t art i nq w i t h 



i 1 



i cj n o r e d , t 



•■■■■E 



fl line i n t h e t r an s f e r f i 1 e 

a 1 1 o 1...1 f o r d o c u m e n t at i o n . 

The format of the command is TR, NfiMR. The end of the file is an 

implied --"E command, and TR with no NfiMR is an i d TR,1. 

This has the possibility of saying groups of fi t h no operator 

i n t e r y e n t i o n . H T E ! , t h e c o m m an d f i 1 e i t s e 1 f c :.. :. e o n e o f t h e 

files sayed as it will be open during the search f.-^aiei 

fi 1 s o , C o m m an d f i 1 e s c an n o t b e s t ac k e d . 

END OF SEfiRCH 

This command is used to 1 eaye the interactive search phase and go 

on to the file saye phase. 



SfiVER can also get it's commands from t i un string which) scheduled 
t h e p r o g r am . F o r e x am p 1 e , R U , S fi V E R ? S E . 1 ; V E R : : E E , ■■■' E w o u 1 d c au s e t h e 
program to find files such as &SRVER and >;SfiVER on disc BE and save them, 
to LU S, doing a yerify. 

F o r a 1 1 o f t h e i n t e r ac t i y e c o m m an d s , e x c e p t s e ar c h , t h e e f f e c t o f t h e 
c o m m an d c an b e c an c e 1 e d b y r e - i s s u e i n g t- ! >. c o rn m an d ■ F o r e x am p 1 e , i f y o u 
t y p e V E w h i c h w o u Id disable t ap e y e r i f y , e ; . t e r i n g V E ag a i n w ill re- e n ab 1 e 
the yerify. The action of the commands is to toggle the state of the 
program f 1 ags. 

FILE SAVE PHASE 

SfiVER computes an estimate of the 1 er " h of the tape needed to saye 

t h e f i 1 e s an d as k s p e r m i s s i o n t o c o ! . * j e . I f '' N ■' i s e n t e r e d , 

t h e p r o g r am w ill t e r m i n at e . D e f au 1 1 is '" V E S "' . 

I f r u n n i n g u n d e r c o n t r o 1 o f a r u n s t r i n g , t h e q u e s t i o n i s r h e t o r i c a 1 

as t h e p r o g r am w ill n o t w a i t f o r p e r m i s s i o n b e f o r e p r o c e e d i n g . 

fi f t e r t h i s , S fi V E R is n o t i n t e r ac t i y e d u r i n g t h i s p h as e , s o t h e o n 1 y 

way to command it to do anything is to set the attention flag 

■:! E R , S fi V E R > w h i c h c au s e s t h e p r o g r am t o t e r m i n at e . 



FILE PURGE PHfiSE (optional) 

T h e p u r g e p r o rn p t is " P u r g e 

I f y o u e n t e r "' N " , t h e p r c 

I f y o u e ri t e r " ALL ■" , t h c p r 

% o d o t h is?". Fi n y an s u e r 

■'' H '' r e s p o n s e a n d t h e p r c 

I f y o u e n t e r "' Y E S " , t h e p 



f i les <H0, SOME or RLD?" 
gram t erm i nat es . 
ogram will then ask "fire you sure you want 

other than •"YES"' will be taken as a 
gram will go back to the purge prompt, 
r ogram will purge all the files that were 
sayed to tape. You can set the break flag (ER, SfiVER) to abort. 
If you enter "SOME"', the program will then ask for each file if 
it is to purge that file, skip it, or terminate the program. 
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